Manual
Installing, controls and connecting your trainer.
Installing on Windows
- Download a build from the downloads page.
- Extract the whole zip file to a folder you can write to. Keep all files together.
- All-in-one: start
Velodrome.exe. It starts the bridge and the game together and stops the bridge when you close the game. Don’t startVelodromeGame.exedirectly. - Game only: start
Start-Velodrome.cmd. The first start creates your settings with 24 fictional riders.
Keyboard controls
These are the default keys during a race. You can change them in the settings (F10).
| Key | Action |
|---|---|
| A / D | Steer |
| ↑ / ↓ | Without a trainer: power +/− 25 W. With a trainer: virtual shifting |
| + / − | Power up or down |
| C / Q | Next or previous camera |
| B | Look back |
| V | Rider info |
| R | Restart |
| Esc | Pause menu |
| F10 | Settings |
Without a trainer the game uses an energy model to simulate your power. It is not a real power measurement.
Connecting your trainer and controller
The game talks to your hardware through a separate bridge. In the all-in-one build it starts by itself. If you run the game only, or work from source, start the bridge yourself.
- Close other apps that use your trainer, controller or ANT+ stick, such as Zwift or Garmin Express.
- On Zwift Ride, turn on the left controller first, then the right one. Turn on your trainer.
- For heart rate: plug in the ANT+ stick and turn on Broadcast Heart Rate on your Garmin.
- From source: run
bridge/start_windows.bat(Python 3.12, internet needed on first run). Without a heart-rate stick:start_windows.bat --no-ant. - Start the game. The bridge keeps searching until your devices are available and reconnects if the connection drops.
If you feel unexpected resistance, stop pedalling. If the game or the connection drops, the software can’t guarantee your trainer releases the resistance.
Compatibility
Supported in code. This is not a guarantee for every device or firmware version.
| Wahoo KICKR / KICKR CORE | Bluetooth FTMS: power, speed and cadence; SIM, ERG and gradient simulation. Other FTMS trainers are not confirmed. |
|---|---|
| Zwift Ride | Bluetooth via the left controller: 12 virtual gears, buttons and analogue steering paddles. Buttons can be remapped under Settings → Controller. |
| Garmin heart rate (ANT+) | Through an ANT+ USB stick. Turn on Broadcast Heart Rate on your watch, for example a vívoactive 5. |
ERG mode works between 0 and 1300 W, within what your trainer reports it can do. The virtual gears are an approximation and don’t use a native Wahoo or Zwift protocol.
Settings and data
Riders and Strava are configured with files in the config/ folder next to the game. Keep the rider IDs when you change names so your records stay linked. For Strava, enter your own details in strava_config.cfg.
On Windows your records, saved rides and settings are stored in:
%APPDATA%\Godot\app_userdata\Velodrome 250 - Sprint Beta\
On slower PCs, choose F10 → Display → Simple graphics. It uses a smaller crowd and a shorter intro and takes effect after a restart.