Repository navigation
Releases: pepperstm/velopopuli
Release list
VeloPopuli v0.3.0
VeloPopuli — the people's indoor ride. Ride real GPX routes in 3D on your smart trainer. Free and open source. velopopuli.com · Guides
This is an early release. The 3D world, physics, workouts and progress tracking are well tested; real trainers and sensors are only now being tried, and the Windows and Linux builds have had little use. If something doesn't work, the app's Report a problem → Report on GitHub builds a diagnostics report for you — please send one.
What's new in 0.3.0
- Virtual gears (optional): leave the bike in one gear and shift with keys, a Bluetooth remote or on-screen buttons. Set up your own chainrings and cassette or pick a preset; the trainer's resistance changes so each gear feels real. Riders who shift their bike's own gears don't need to change anything. How it works
- Now licensed under the GNU GPL v3 or later, so VeloPopuli and anything built from it stays open source. Earlier versions have been relicensed too.
- For contributors: a contribution guide, project handoff notes, issue and pull-request templates, and automatic formatting checks.
Download
| System | File | Notes |
|---|---|---|
| macOS (Apple Silicon and Intel, 10.15+) | VeloPopuli_*_universal.dmg |
Drag to Applications. Not notarised yet: the first time, open System Settings → Privacy & Security → Open Anyway (or run xattr -dr com.apple.quarantine /Applications/VeloPopuli.app). |
| Windows 10/11 (64-bit) | VeloPopuli_*_x64-setup.exe or VeloPopuli_*_x64_en-US.msi |
Not code-signed yet: if SmartScreen warns, choose More info → Run anyway. ANT+ sticks need the WinUSB driver (Zadig). |
| Ubuntu / Debian (and Mint, Pop!_OS…; 64-bit) | VeloPopuli_*_amd64.deb |
sudo apt install ./VeloPopuli_*_amd64.deb — installs the ANT+ stick permission rule too. |
| Arch Linux (and Manjaro, EndeavourOS…) | velopopuli-bin-*-x86_64.pkg.tar.zst |
sudo pacman -U velopopuli-bin-*.pkg.tar.zst. The PKGBUILD is attached too. Install bluez for Bluetooth. |
| Any other Linux (64-bit) | VeloPopuli_*_amd64.AppImage |
chmod +x and run. |
Group-ride relay (optional, for hosting rides with friends): velopopuli-relay-* for macOS, Windows and Linux — see Group rides and self-hosting.
Setting up: Installing · Connecting your trainer · Your first ride
VeloPopuli v0.2.0
VeloPopuli — the people's indoor ride. Ride real GPX routes in 3D on your smart trainer. Free and open source. velopopuli.com · Guides
This is an early release. The 3D world, physics, workouts and progress tracking are well tested; real trainers and sensors are only now being tried, and the Windows and Linux builds have had little use. If something doesn't work, the app's Report a problem → Report on GitHub builds a diagnostics report for you — please send one.
Download
| System | File | Notes |
|---|---|---|
| macOS (Apple Silicon and Intel, 10.15+) | VeloPopuli_*_universal.dmg |
Drag to Applications. Not notarised yet: the first time, open System Settings → Privacy & Security → Open Anyway (or run xattr -dr com.apple.quarantine /Applications/VeloPopuli.app). |
| Windows 10/11 (64-bit) | VeloPopuli_*_x64-setup.exe or VeloPopuli_*_x64_en-US.msi |
Not code-signed yet: if SmartScreen warns, choose More info → Run anyway. ANT+ sticks need the WinUSB driver (Zadig). |
| Ubuntu / Debian (and Mint, Pop!_OS…; 64-bit) | VeloPopuli_*_amd64.deb |
sudo apt install ./VeloPopuli_*_amd64.deb — installs the ANT+ stick permission rule too. |
| Arch Linux (and Manjaro, EndeavourOS…) | velopopuli-bin-*-x86_64.pkg.tar.zst |
sudo pacman -U velopopuli-bin-*.pkg.tar.zst. The PKGBUILD is attached too. Install bluez for Bluetooth. |
| Any other Linux (64-bit) | VeloPopuli_*_amd64.AppImage |
chmod +x and run. |
Group-ride relay (optional, for hosting rides with friends): velopopuli-relay-* for macOS, Windows and Linux — see Group rides and self-hosting.
Setting up: Installing · Connecting your trainer · Your first ride
Licence: VeloPopuli is licensed under the GNU GPL, version 3 or later. This release was first published under the MIT licence; on 19 October 2026 the copyright holder relicensed it under GPLv3. Copies obtained under MIT before then keep their MIT rights.