Settings

Handheld Companion features a GUI with several pages featuring different settings and options. This wiki page provides information on the various possibilities on the pages.

Controller

Handheld Companion Controller Page

The controller page.

Connect selected virtual controller
Select controller type, Emulated DualShock 4, Emulated Xbox Controller
Vibration strength, configure desired vibration strength of device 0 - 100 % in increments of 10.

Input devices

Select preferred input device for emulated controller, all detected controllers (built in and external) are shown here.

Device Cloaking

Device cloak, cloak device check box.
Device cloak, uncloak on close check box.

Profiles

Handheld Companion Profiles Page

Profiles page, application specific settings, related to the .exe filename.

Profiles, list of applications for which Handheld Companion can be used and options can be set respectively. The application comes preloaded with several popular profiles.
Profiles, Create new profile.

Profile Details

Name, name of executable without extension (case insensitive).
Path, application name with path prefix for which the profile is applicable.
Delete profile, remove the profile from your system
Update profile, apply made changes immediately, applicable for all settings on the profile page and allows for live adjustment in game.
Enable profile, toggle on off, profile can be disabled. Note that the Default profile will always be applied.

Profile settings

Global settings

Allow application access to device physical controller, checkbox. Allow the application to access the physical controller (therefore ignore gyro functionalities). This option is here to avoid having to turn off the service for a specific game. Also known as "Passthrough".
Translates XInput call to DirectInput calls checkbox. DS4 Controller is a DInput controller. A few games can't handle DInput controllers so it'll disguise the DS4 DInput controller as a XInput XBOX controller. Also known as "Wrapper". "This could trigger a few anti-cheat systems!

Motion control settings

Gyrometer Multiplier, multiplies angular velocity values.
Accelerometer Multiplier, multiplies acceleration values.
Gyro Steering Axis, Roll or Yaw. Select the desired steering axis.
Invert Horizontal Axis, invert looking left and right motion.
Invert Vertical Axis, invert looking up and down motion.

Universal Motion Control (UMC) settings

UMC allows the user 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. It is recommended to rely on Steam controller support whenever possible because of how efficient and configurable it is. UMC was made to make sure all games are covered, including Microsoft Store titles.

Universal Motion Control (UMC), translate gyroscope to control. Tick to enable options on right side pane.

Style of input, drop down selection:

Right stick
Left stick
Mouse

Enable Button, drop down selection:

A
Always on
B
Back
DPad Down
DPad Left
DPad Right
DPad Up
Left Shoulder
Left Thumb
Left Trigger
Right Shoulder
Right Thumb
Right Trigger
Start
X
Y
Sensitivity, linear increase of the reading. Default: 1000, range 500 - 2000
Intensity, exponential increase plus compression of higher value. Use this to drastically increase small value at the cost of precision.

Settings

Handheld Companion Settings Page

The Settings page allows for configuring the GUI interaction behavior and handling the service.

Interface

Auto start application, tick to have the GUI application start on Windows boot.
Open application in background, tick to have the GUI application start minimized in the system tray.
Close minimizes, tick to have the GUI application minimize to the system tray when closing the window using the X button.
Application theme, dark or light mode GUI colors.

Notifications

Toast notification, tick to enable or disable Windows system notification by Handheld Companion.

Service Startup Type

Automatic, ?
Manual, the user manually starts the service through windows services manager or through controller helper every time gyro control is wanted.
Disabled, prevents the service from executing.