Install on macOS

Cyclemetry runs natively on macOS 12 Monterey and later, on both Apple Silicon (M1/M2/M3/M4) and Intel Macs.

Download the latest release

Go to GitHub Releases and download the .dmg file for your architecture:

Cyclemetry_x.x.x_aarch64.dmg — Apple Silicon (M1 and later)
Cyclemetry_x.x.x_x64.dmg — Intel

Open the DMG and drag to Applications

Double-click the .dmg to mount it, then drag Cyclemetry.app to your /Applications folder.

Remove the quarantine attribute

Because Cyclemetry is not signed with an Apple Developer certificate, macOS will block it from opening by default. Run this command once in Terminal:


xattr -cr /Applications/Cyclemetry.app

Why the terminal command? Apple requires a $99/year Developer Program membership to notarize apps for distribution. The workaround above removes the macOS quarantine flag manually. It’s a one-time step. Help fund a Developer Program membership and eliminate this step for everyone! →

Launch Cyclemetry

Open Cyclemetry.app from your Applications folder or Spotlight (⌘ Space).

Build From Source

If you prefer to build Cyclemetry yourself, you can build it from source:

Prerequisites

You will need the following tools installed on your Mac:

Xcode Command Line Tools (run xcode-select --install in Terminal)
Node.js (v20+)
pnpm
Rust via rustup
FFmpeg (e.g., via Homebrew: brew install ffmpeg)

Build


git clone https://github.com/walkersutton/cyclemetry.git
cd cyclemetry
pnpm install
pnpm build

The built .dmg and .app bundle will appear in src-tauri/target/release/bundle/.

Updates

Cyclemetry checks for updates automatically on launch and shows a banner if a new version is available. You can also check manually from Cyclemetry → Check for Updates in the menu bar.

Troubleshooting

“Cyclemetry is damaged and can’t be opened”

This is the Gatekeeper quarantine flag. Run the xattr -cr command above and try again.

“Cyclemetry cannot be opened because the developer cannot be verified”

Same cause. You can also go to System Settings → Privacy & Security and click Open Anyway after attempting to launch.

App opens but render fails

Make sure your GPX file has timestamped trackpoints (<trkpt> elements with <time>). Some export tools strip timestamps. Re-export from your device or head unit directly.