Skip to content

Pair with Zwift

TL;DR

Start the app and pick your controller. In Zwift's Paired Devices screen, choose Voltage Gamepad as the Power Source for a moment. Then choose Voltage Gamepad under Controls. Finally, set Power Source back to your trainer. The first time, Zwift also runs a short Zwift Ride tutorial.

The app shows up in Zwift as a Zwift Ride controller named Voltage Gamepad. You connect to it on Zwift's Paired Devices screen.

Same computer or a different device?

Both work.

  • Same computer: run the app and Zwift on the same Windows PC.
  • Different devices: run the app on a Windows PC and Zwift on another device, such as a Mac, tablet, phone or Apple TV. Both devices must be on the same local network (for example the same home Wi-Fi).

Step by step

1. Start the app and pick your controller

Start Game Controller for Zwift and choose your controller from the list (see Install and first run). Keep the app running while you ride.

2. Open the Paired Devices screen

Start Zwift and go to the Paired Devices screen. Your trainer already shows as Connected, but the Controls tile still says Search.

Zwift Paired Devices screen. Power Source, Resistance, Cadence and Heart Rate show the trainer as connected. The Controls tile is orange and says Search.
Before pairing: Controls says Search.

3. Pick Voltage Gamepad as the Power Source

Click the Power Source tile. The Pair Device list opens. Select Voltage Gamepad, then click Close.

Zwift Pair Device list for Power Source with two entries: the trainer and Voltage Gamepad.
The Power Source list shows your trainer and Voltage Gamepad.

4. Check the Power Source tile

The Power Source tile now shows Voltage Gamepad as connected. This is only for a moment. Voltage Gamepad sends no power, so the tile shows 0 watts.

Zwift Paired Devices screen with Voltage Gamepad connected as the Power Source. Controls still says Search.
Voltage Gamepad is the Power Source for now.

Why choose Power Source first?

Picking Voltage Gamepad as the Power Source triggers the communication handshake between Zwift and this app. This handshake needs to happen at least once per Zwift session to enable Controls integration. Once Controls is filled in, you can select your real Power Source. Voltage Gamepad does not send power or cadence. Your trainer must provide those.

5. Pick Voltage Gamepad under Controls

Click the Controls tile. In the Pair Device list, check Voltage Gamepad, then click Close.

Zwift Pair Device list for Controls with Voltage Gamepad checked.
Check Voltage Gamepad in the Controls list.

6. Check the Controls tile

The Controls tile turns blue, shows a Zwift Ride handlebar icon and says Voltage Gamepad with Connected below it.

Zwift Paired Devices screen. Controls shows a handlebar icon and Voltage Gamepad as connected. Power Source still shows Voltage Gamepad.
Controls is connected to Voltage Gamepad.

7. Go through the Zwift Ride tutorial (first time only)

The first time Zwift sees a Zwift Ride, it runs a short tutorial. It starts with a welcome screen. Then it shows one screen per action, such as steering, braking and shifting. Do each action with your game controller, using the buttons you mapped in Map your controller. If you want to skip it, click Skip Tutorial in the top right corner or select the Z-mapped button on your controller.

Zwift Ride tutorial screen titled Steer clear of obstacles. It asks to tilt the right paddle ZR outward to steer right.
A tutorial screen: use your Steer right input.

8. Set the Power Source back to your trainer

Click the Power Source tile again. Select your trainer or power meter, then click Close. Check that Resistance and Cadence also show your real devices. Keep Controls on Voltage Gamepad. Click OK and start riding!

Zwift Paired Devices screen in the final state. Power Source, Resistance, Cadence and Heart Rate show the trainer. Controls shows Voltage Gamepad. All tiles say Connected.
Done: your trainer is the Power Source and Voltage Gamepad is the controller.
flowchart TD
    a["Open the pairing screen"] --> b["Power Source: Voltage Gamepad"]
    b --> c["Controls:<br/>Voltage Gamepad"]
    c --> d["Power Source, Resistance, Cadence:<br/>your trainer"]
    d --> e["Controls stays on<br/>Voltage Gamepad"]
    e --> f["Ride On!"]

Next time

The tutorial only runs once. The handshake is needed once per Zwift session, though. So each time you start Zwift, repeat steps 3 to 6 and step 8: pick Voltage Gamepad as the Power Source, pick it under Controls, then set the Power Source back to your trainer.

What connected looks like

  • On the pairing screen, Controls shows Voltage Gamepad as connected.
  • In a ride, pressing your shift buttons changes gear, and pressing your navigation buttons moves through Zwift's menus.
  • The app's log file records DIRCON RideOn handshake completed when Zwift has connected. See Troubleshooting for where to find the log.

If Voltage Gamepad does not appear, see Troubleshooting.

Next step

Choose what each button does in Map your controller.