Common questions:
- What is Handheld Companion?
- How do I use it?
- What is the best way to use my controller in games/emulators?
- What's Universal Motion Control / UMC
- Should I always use UMC?
Troubleshooting:
- I can't get my games to receive inputs
- Certain buttons are greyed out, I can't apply changes through the Helper?
- I uninstalled Handheld Companion from my system but now may Ayaneo's controller no longer works!
- Double input effects within Steam
- Regular controls work in game but universal motion control does not
- I can't see my cursor in game
Check out the repository README and the main project page.
Follow the Installation Guide.
You need to verify which Input API is supported in whatever you are using and if you want to use the virtual DS4 specific functions, like motion controls. The following table should help you:
UMC allow you to translate gyroscope inputs straight into joystick inputs (left stick, right stick) making it a universal approach for games that can't be launched through Steam. UMC also offers a limited level of flexibility through settings like Enable Button, Sensivity, Intensity.
We recommend relying on Steam controller support whenever possible because of how efficient and configurable it is. We made UMC to make sure all games are covered, including Microsoft Store titles.
Not all modern games natively support DS4 controllers. None of them natively support motion control. To address that issue, you have a few options.
- To get generic compatibility, follow the Application is not a game guide.
- To get extended compatibility (including motion control), add your game to Steam and follow our Playing on Steam guide.
You'll need to create a specific application profile through Controller Helper. Do as follow.
- Start Controller Helper.
- Profiles > Create new profile.
- Select the executable of your targeted application.
- Tick either Whitelisted or Use Wrapper.
Run the Helper with administrator rights. The Helper works both with and without admin rights, to enact changes within the service, admin rights are required.
Reinstall the Handheld Companion run the application as admin. Stop the service. Delete service. Uninstall. See the Installation page for detailed instructions.
If Xbox Extended Feature Support is checked on steam controller settings, uncheck it. (Xbox Extended Feature Support checkmarked and caused steam to load a driver at startup. I uncheck that, it uninstalled the driver and now I no longer see the xbox360 controller in steam.) If it's not, click on windows, then type joy.cpl and make sure only one controller is visible. If only one controller is visible but steam still receive two inputs, restart the device.
TODO
Double check the correct executable (*.exe file) is used in your profile settings. Some games have multiple or a main which opens a specific sub version, for example a 32 or 64 bit variant, which is the one that needs to be selected. Example:
Does not work: "C:\Games\Windows\Ghostrunner\Ghostrunner.exe"
Does work: "C:\Games\Windows\Ghostrunner\Ghostrunner\Binaries\Win64\Ghostrunner-Win64-Shipping.exe"
It's possible to check which executable is actually running throught Taskmanager -> Processes tab -> Background Processes list, looks for your game name.
In case of doubt, try all.
Some games expect a hid mouse to be connected in order to show a cursor. Install HP virtual mouse driver found here: Download Information