Getting Started

Requirements

A smart trainer (any FTMS-compatible: Wahoo Kickr, Elite Direto, Tacx NEO, Saris H3, etc.)
Bluetooth 4.0+ on your computer
macOS 12+, Windows 10+, or Linux (Ubuntu 22.04+)

Install

Download KRANQ from kranq.fit/download. Install for your platform and launch.

macOS: open the .dmg and drag to Applications. Windows: run the .msi installer. Linux: make the .AppImage executable and run it.

Connect your trainer

Open KRANQ, click Scan for Devices in the left sidebar. Your FTMS trainer will appear within a few seconds. Click Connect. Wait for the green “Connected” status.

KRANQ works with any trainer that broadcasts FTMS (Fitness Machine Service) over Bluetooth: Wahoo Kickr, Elite Direto, Tacx NEO, Saris H3, JetBlack, and many more.

Connect heart rate

Any Bluetooth HR strap works. Polar, Garmin, Wahoo, Coros — KRANQ uses the standard BLE Heart Rate Service (UUID 0x180D). Just scan and connect.

Import a route

Click Import GPX in the Routes section. Select a .gpx file from your computer (download routes from Strava, Komoot, RideWithGPS, etc.). The route appears in Explore KRANQland.

Or browse the built-in KRANQland virtual routes — no import needed.

Your first ride

Select a route, click Start Ride. Cruise mode shows the elevation profile with your position. Press G to switch to Grind mode for full telemetry, or Clean mode for a minimal dashboard.

Use arrow keys to shift gears. Press Space to pause, Escape to stop.

Workout builder

Create workouts with the visual builder: add intervals, set power targets, cadence ranges, and HR zones. The power profile chart updates in real time.

Import Zwift .zwo workout files or export your workouts to .zwo for use in other apps. The native .kranq format preserves cadence and HR zone data that .zwo doesn't support.

Route-fused workouts

Load a route AND a workout, then start the ride. You ride the route visually while the workout controls trainer resistance. Best of both worlds — structured training with real-world terrain.

Upload to Strava

Connect your Strava account in Settings using the official “Connect with Strava” button. After each ride, choose “Upload to Strava” on the ride complete screen.

Your ride appears on Strava with full power, heart rate, cadence, and KRANQland GPS coordinates.

KRANQland coordinates

Every ride gets placed in KRANQland, a virtual location in the South Pacific. Your Strava map shows the real route shape (hairpins, switchbacks) positioned in the ocean. All your KRANQ rides cluster together on the map.

Keyboard shortcuts

Key	Action
`Space`	Pause / resume
`Escape`	Stop ride
`G`	Toggle Cruise / Grind / Clean mode
`↑ / ↓`	Shift rear gear
`← / →`	Shift front chainring
`+ / −`	Adjust ERG power ±10W

All shortcuts also have on-screen buttons for touch/tablet use.

File formats

.kranq — Native JSON workout format. Human-readable, shareable, preserves cadence and HR zones.
.zwo — Zwift workout format. Import and export supported. Cadence/HR data is dropped on export (not in Zwift spec).
.gpx — GPS route files. Import from Strava, Komoot, RideWithGPS, etc.
.tcx — Ride export format used for Strava upload.