Troubleshooting Your Controllers During A Parsec Stream

CHECK TO MAKE SURE THE CONTROLLER DRIVERS ARE INSTALLED ON HOST

First, please check that the controller software is installed on the host. If it's not, install this software on the host PC. Please make sure that you install the 32-bit version if you're using 32-bit Windows or 64-bit version if you're using 64-bit Windows.

Parsec uses an open source virtual controller driver called ViGEm maintained by Benjamin Höglinger (nefarius). The driver and library are under an MIT License.

The driver was updated to version 1.13.0.0 on September 11, 2017.

You can verify that the controller was installed in your device manager. There will be an Xbox controller there.

xbox_device_manager.png

 

CONFIRM YOUR CONTROLLER IS X-INPUT

Parsec works with X-input controllers (Xbox One/Xbox 360) out of the box, and it typically works well with D-input. We recommend using X-input if it's possible on your PC. If it's not, and your controller isn't working, try mapping the controller with the SDL tool listed at the bottom of this page.

If your controller is something other than an Xbox One/Xbox 360 controller, you'll need some software on the client computer to convert the inputs to x-input.

See our article here about the PS4 controller.  

 

REBOOT YOUR HOST

ViGEm is a driver, more often than not, drivers require a reboot in Windows.  If things are not working, please ask the person hosting to reboot their PC.

 

YOUR CONTROLLER IS REGISTERED AS A MOUSE

In Steam Big Picture Mode, Xbox controllers are set in Desktop Mode by default. This means that the controllers are considered a mouse and keyboard. You should disable this setting in Steam Big Picture Mode. The controller your using will then act like a controller. You can also avoid this by not entering Steam Big Picture Mode on the host. For a step-by-step guide to turn this off click here.

 

CONFIRM THAT THE CLIENT COMPUTER IS REGISTERING THE CONTROLLER

Head to HTML5 Gamepad to confirm that your controller buttons are being registered and that the controller is in x-input mode. Parsec only works with x-input controllers.

Please visit this GitHub Repo for a driver that will make your Xbox controllers work with MacOS. For the Raspberry Pi, you can sudo apt-get install xboxdrv for Xbox controller support.

 

MACOS CONTROLLERS

Install the drivers for your controller - Macs only recognize Direct Input controllers. If you're trying to use an Xbox controller or another device using Xinput, there are a few driver options out there. Here's a great Xbox controller driver for the Mac that works with Xbox 360 and Xbox One controllers. If the driver requests security permissions, you must approve them to get the controllers working. Once the driver is installed, Parsec will recognize your controller.

The DS4 controller works automatically with macOS and Parsec when connected via USB cable

MACOS CONTROLLERS USING BLUETOOTH

Xbox One Bluetooth controllers don't work well with Parsec currently, and may map incorrectly. In order to use an Xbox One controller with macOS, you'll need to use a USB cable (and the Xbox controller driver)

RASPBERRY PI XBOX CONTROLLERS

If you're using the Raspberry Pi version of Parsec, you'll need to install drivers for the controllers. The best Xbox driver we've found is xboxdrv. For the Raspberry Pi, you can sudo apt-get install xboxdrv.

Unfortunately, however, if you have an Xbox One S and want to use the bluetooth connection, you'll need this driver

CONTROLLERS ON ANDROID

Controller support on Android is inconsistent due to the large amounts of phone makers offering different levels of compatibility.  The general rule here is that there are no rules, your best bet is to update your gamepad firmware (eg. there was a major firmware update for Xbox One controllers with Bluetooth that improved compatibility with Android).  You also may have different results with an OTG cable rather than Bluetooth also.

We are continuously working to improve support for controllers in Android

 

REMAPPING CONTROLLERS

You can remap your controllers by either clicking on the Parsec button in the upper-right corner, or you can use the hotkey - ctrl + alt + m.

remap.png

 

 

RESET YOUR CONTROLLERS IF THE DRIVER IS INSTALLED

If the controller is installed, please try resetting the controller driver on the host PC. Right click on the Parsec logo in your host computer's task tray and select "Reset Joysticks."

 

IF ALL ELSE FAILS...

Parsec uses SDL for controller mapping on the client. Your controller might not be recognized by SDL. If you're having issues with the controller mapping beyond the simple steps, you can try to add your controller to Parsec via brute force.

  1. Click on the advanced settings link in the settings tab of your client computer (changing this on the host settings isn't necessary).
  2. Create a file called controllers.txt in that folder.
  3. Use this tool to create an SDL mapping for your controller.
  4. Copy the SDL mapping from the tool and paste it into the controller.txt file.
  5. Quit Parsec.
  6. Relaunch Parsec.