Skip to content
pepperstm edited this page Nov 12, 2026 · 5 revisions

VeloPopuli

The people's indoor ride: open source, built by riders, for riders. — velopopuli.com

Climbing Alpe d'Huez in VeloPopuli

VeloPopuli turns any GPX route into a 3D world built from OpenStreetMap and open elevation data, drives your smart trainer from the real gradient, and makes a game of it with ghosts, pace riders, timed climbs, workouts and a season goal. It's free, open source (GPLv3) and runs on Windows, macOS and Linux.

Start here

Using the app

  • Routes and the map — importing, planning and finding routes, Herne Hill Velodrome, and the world around you
  • Riding — the screen and keys, gradient and ERG, laps, ghosts and pace riders, time of day and weather, ending a ride
  • Workouts — built-in sessions, importing .zwo/.erg/.mrc
  • Virtual gears — shift with keys or a remote instead of your bike's gears (optional)
  • Progress and goals — power curve, FTP, training load, streaks, badges and the season goal
  • Strava — upload rides, ride your Strava routes, race your rides as ghosts, segments
  • Dreeve — upload rides to your own Dreeve server, and ride them again
  • Group rides and self-hosting — ride together; run your own relay
  • Fan and lights — Home Assistant, Shelly, Tasmota and webhooks

Help

For developers

  • Contributing — how to help
  • VeloPopuli for developers — how the app is built, part by part: architecture, building and testing, routes, physics, the ride, the 3D world, drawing, devices, connectors, data and releasing. These pages live in the repository, next to the code.

VeloPopuli is young. The 3D world, workouts and progress tracking are well tried, but only a few trainers and sensors have been used with it so far. If something doesn't work with yours, a diagnostics report is the quickest way to get it fixed.

Clone this wiki locally