Repository navigation
VeloPopuli v0.3.9
·
14 commits
to main
since this release
Immutable
release. Only release title and notes can be modified.
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.9
- Handlebar controllers. Controllers that speak OpenBikeControl, an open protocol for handlebar buttons, now work over Bluetooth. Shift virtual gears, raise or lower the ERG target or workout intensity, skip a workout step, pause and switch camera without letting go of the bars. Pair one under Devices → Add Bluetooth device…; it shows as Controller. Thanks to Jonas Acker for adding it.
- Pairing, written up. The README and the guides now walk through pairing a Bluetooth device step by step, and what the Devices list tells you.
- Controller support is new and hasn't been tried with a real controller yet. If yours misbehaves, Report a problem in the app gathers what's needed to fix it.
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