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.
- Download Controller Driver Installer 126.96.36.199 (64-bit)
- Download Controller Driver Installer 188.8.131.52 (32-bit)
The driver was updated to version 184.108.40.206 on September 11, 2017.
When someone connects with a compatible controller, you'll see an Xbox controller in device manager like so;
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.
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.
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
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.
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.
- Go to %appdata%/Parsec in File Explorer (~/.parsec on Linux, Mac OSX, RPi)
- Create a file called controllers.txt in that folder.
- Use this tool to create an SDL mapping for your controller.
- Copy the SDL mapping from the tool and paste it into the controller.txt file.
- Quit Parsec.
- Relaunch Parsec.