Troubleshooting
The troubleshooting guide for Virtual GamePad.
Troubleshooting
If your problem is not covered here, file an issue.
Help! I cannot connect to the server
If you’re having trouble connecting to the server, try disabling your firewall or adding an exception for the server.
On Windows, you will be prompted to allow the server to communicate through the firewall when you run it for the first time.
If you’re still having trouble, start a hotspot on your phone and connect your PC to it. (or vice-versa, try both)
Then, restart the server and try connecting again.
Do this before complaining about the app not working.
Help! The client is connected but the Gamepad doesn’t work for any game
Check the Preferences screen in the server. Different input methods (Keyboard/Mouse or Gamepad) have different requirements.
On Windows, the Keyboard/Mouse mode works out of the box. The Gamepad mode requires:
- The admin privilege. (Right click and Run as admin)
- App sideloading (developer mode) enabled. (Settings > System > For developers > Developer mode).
On Linux, the server requires rw access to /dev/uinput. Multiple ways to achieve this are described in-app.
Help! The Gamepad doesn’t work for a game
Try running the server as admin. 🛡️
The game should not be running as admin. This prevents input injection.
Games without gamepad support should work out of the box.
Read How it works to know why.
Help! The gamepad feels laggy/unresponsive
This is covered in the FAQ.
Bonus XKCD Comic
Tech Support Cheat Sheet — XKCD 627:
