Install and first run¶
This page gets the app running on your Windows computer. It takes about five minutes.
1. Download the app¶
Go to the Releases page on GitHub and open the newest release. You will see two downloads. Pick one:
| Download | Size | What you need |
|---|---|---|
GameControllerForZwift-<version>-win-x64.zip |
Small | Requires the .NET 10 Desktop Runtime. If this is missing, Windows tells you when you start the app and offers to download it for you. |
GameControllerForZwift-<version>-win-x64-standalone.zip |
Larger | Nothing else. Everything is inside. |
Not sure which one?
Take the standalone download. It is bigger, but it works without installing anything else.
Each release also has a SHA256SUMS.txt file. You can use it to check that your download is complete and unchanged.
Windows on ARM¶
If your PC has an ARM processor (for example a Snapdragon laptop), the x64 release runs on it through the built-in x64 emulation of Windows 11. CI starts every build on a Windows 11 ARM machine to check this. The standalone zip needs nothing extra. The smaller zip needs the x64 version of the .NET 10 Desktop Runtime, which you can get from the official .NET download page. I suggest the x64 installer, not the Arm64 one. I do not offer a native Arm64 build yet.
2. Unpack and start¶
- Right-click the zip file and choose Extract All.
- Open the extracted folder and run
GameControllerForZwift.exe.
If Windows SmartScreen stops the app¶
The app is not digitally signed yet, so Microsoft Defender SmartScreen may show a warning the first time. Click More info, then Run anyway. The app starts.
Allow the app through Windows Firewall¶
The first time the app runs, Windows Firewall asks whether the app may use the network. Allow it on private networks (your home network). Zwift finds the app over your local network, so this step matters.
Why the app needs the network
Zwift discovers controllers on your network and then talks to them over a normal network connection. The app listens on TCP port 36866 (or the next free port up to 36876) and announces itself with mDNS on UDP port 5353. You do not need to open anything on your router.
3. Connect your game controller¶
- Connect your controller to Windows with a USB cable or Bluetooth.
- In the app, choose your controller from the list. The list updates by itself within about half a second when you connect or disconnect a controller. If you have only one controller, the app selects it for you.
- Press some buttons. The matching row in the app lights up while you press it.
The app uses one controller at a time. If you connect left and right Nintendo Joy-Cons to your computer, the app will count them as a single controller.
Next step¶
Your app is ready. Now pair it with Zwift.