README.md

Cyclemetry

Open-source desktop app for creating cycling telemetry video overlays from GPS data.
Import a ride, design your overlay in a live editor, and export a finished video — no subscription, no cloud.

What it does

Cyclemetry reads a GPX file and renders cycling metrics — speed, power, heart rate, elevation, cadence, gradient, and live map position — directly into your video as a customizable overlay. The output is a standalone video file ready to upload to YouTube.

Key details:

• Drag-and-drop overlay editor with a live preview canvas
• Template system: start from a built-in template or build your own from scratch
• Native Rust rendering pipeline — fast
• FFmpeg-based export at your chosen resolution
• Runs entirely on your machine — no account, no internet connection, no recurring cost

Install

Download for macOS (Apple Silicon & Intel), Windows, or Linux:

→ cyclemetry.walkersutton.com/install

Templates

Built-in templates give you a starting point. Drag elements, adjust colors and typography, and save your own.

Safa	NorCal	Will
Jeff	Crit	Aaron

Videos

Videos made with Cyclemetry. Click any thumbnail to watch on YouTube.

Descent into Rincon · Walker Sutton	Seward Park Crit · Walker Sutton
Stunt Descent · Walker Sutton	Testing Cyclemetry · Paolo Tagliaferri

→ cyclemetry.walkersutton.com/videos · submit your own video

Star History

Developing

Local setup, resource bundling, and release steps: cyclemetry.walkersutton.com/developing

pnpm dev      # run with hot-reload
pnpm build    # full distribution build
pnpm lint     # ESLint
pnpm format   # Prettier

Contributing

Pull requests are welcome. For larger changes, open an issue first to discuss direction.