Cyclemetry

Create stunning telemetry video overlays from GPX data.

✨ Features

• Route Tracking: Real-time position on the map.
• Elevation Profiles: Dynamic grade and altitude visualization.
• Rich Metrics: Speed, Power, Heart Rate, Cadence, Gradient, and Temperature.
• Customizable Overlays: Flexible designer to match your video style.

🚀 Installation

1. Download the latest version for macOS from GitHub Releases.
2. You'll need to run this command once to open becuase I'm not paying $100/yr for Apple Developer Account

xattr -cr /Applications/Cyclemetry.app

Currently supported:

• macOS (Apple Silicon & Intel) via .dmg

🛠️ Development

Prerequisites

• Node.js & pnpm
• Python 3.10+ & uv
• Rust

Setup

# Install dependencies
pnpm install

Running Locally

# Run both frontend & backend concurrently (Development Mode - TCP)
pnpm dev

Testing Production (Unix Socket Mode)

To verify the port-less Unix domain socket communication locally:

# Build sidecar and run in socket mode
pnpm buildtest

Videos Made With Cyclemetry

Alternative Tools

• DashWare (only available on Windows)
• Garmin VIRB Edit
• GoPro Telemetry Extractor ($150/$300? - fuck that)

📦 Releasing

git tag v0.2.0
git push origin v0.2.0

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.