VirtualLeverless Receiver is a WebSocket-based server for Windows that enables VirtualLeverless to communicate with a PC. It creates a virtual controller for each connected client using vgamepad and the ViGEmBus driver to simulate pressing and releasing buttons and triggers of an Xbox or PlayStation controller.
- Windows 10 or later
- ViGEmBus driver installed (required for virtual controllers)
- Download ViGEmBus: https://github.com/nefarius/ViGEmBus/releases/tag/v1.22.0
No Python installation is required, the server is provided as a standalone .exe.
- Install ViGEmBus if not already installed. Run the installer and follow the prompts.
- Download
VirtualLeverlessReceiver.exefrom the most recent release (v2.0). - Set up a Cloudflare Tunnel (needed if using the official VirtualLeverless):
- Download and install cloudflared from https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/
- Run a tunnel to forward WebSocket traffic to the server IP/port:
"cloudflared tunnel --url ws://127.0.0.1:8080"
- Run the server:
- Double-click the
.exe - Or run from a terminal:
"cd path\to\exe"
"VirtualLeverlessReceiver.exe"
- Double-click the
- Connect VirtualLeverless to the exposed IP/port (or the Cloudflare Tunnel URL if using remote access).
- Install ViGEmBus if not already installed.
- Download
VirtualLeverlessReceiver.exefrom the most recent release (v2.0). - Run the
.exeby double-clicking it or via a terminal:
"cd path\to\exe"
"VirtualLeverlessReceiver.exe"
⚠️ Remote Access: To allow VirtualLeverless to connect from outside your local network, you must use a tunneling service such as Cloudflare Tunnel. Forward WebSocket traffic to the IP/port the server is listening on.
All received messages are logged with timestamps and client IDs.
Logs are stored in a logs folder next to the .exe.
If you want to run the server from source:
-
Clone the repository:
"git clone https://github.com/jackjburnett/VirtualLeverlessReceiver.git"
"cd VirtualLeverlessReceiver" -
Create and activate a Python virtual environment:
"python -m venv venv"
"venv\Scripts\activate" -
Install dependencies:
"pip install -r requirements.txt" -
Start the server with a custom IP/port (Default:
--ip 127.0.0.1 --port 8080):
"python VirtualLeverlessReceiver.py --ip <IP_ADDRESS> --port <PORT>"
For remote connections, use a tunneling service like Cloudflare Tunnel to forward WebSocket traffic.
- The
.exebundles Python and all dependencies, users do not need Python installed. - Users must have ViGEmBus installed for virtual controllers to work.
- The project currently targets Windows x64. For x86, a separate build is required.
This project is licensed under the GNU General Public License (GPL). See the LICENSE file for details.
For any issues or questions, contact jackjburnett.