Skip to content

AreChen/xpad-server

Repository files navigation

XPAD Server

XPAD Server is the Windows desktop companion for the XPAD Android virtual gamepad client. It receives controller input from the Android app over the local network and exposes it as a virtual Xbox controller on the PC.

Requirements

  • Windows 10 or Windows 11 x64
  • XPAD Android client on the same local network
  • ViGEmBus driver for virtual gamepad support

Download And Run

  1. Download XPAD-Server-v1.0.0-windows-x64.zip from the GitHub Releases page.
  2. Extract the zip to a writable folder.
  3. If this is your first time using XPAD Server, run ViGEmBus_1.21.442_x64_x86_arm64.exe from the extracted folder and restart Windows after installation.
  4. Run XPAD Server.exe.
  5. Allow Windows Firewall access if prompted.
  6. Open the XPAD Android app on the same Wi-Fi or LAN.
  7. Enter the PC IP address shown in XPAD Server and your username, then connect.

Troubleshooting

Android App Cannot Connect

  • Confirm the phone and PC are on the same local network.
  • Confirm Windows Firewall allows XPAD Server.exe on private networks.
  • Confirm UDP port 5000 and TCP port 5001 are not blocked by another security tool.
  • Try using the PC IPv4 address from ipconfig instead of 0.0.0.0.

Virtual Controller Does Not Appear

  • Install ViGEmBus_1.21.442_x64_x86_arm64.exe from the release package.
  • Restart Windows after installing the driver.
  • Run XPAD Server.exe again after the restart.

Driver Installer Is Out Of Date

The bundled driver installer is provided for convenience. The upstream driver project is available at https://github.com/nefarius/ViGEmBus/releases.

Run From Source

py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade pip
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe main.py

Build Release Zip

.\build_release.ps1 -Version 1.0.0

The generated zip is written to release\XPAD-Server-v1.0.0-windows-x64.zip.

License

This project is licensed under the MIT License. See LICENSE for details.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors