karoo-ride-replay — replay a recorded ride's data to test your extension (no ride needed)

Hi!

Sharing this for anyone developing for the Karoo who wants to test an extension end-to-end without going out for a ride every iteration.

karoo-ride-replay is a Karoo extension that loads any FIT file — one of your own recorded rides from FitFiles/, or a sideloaded one — and plays it back as if it were a live ride. Other extensions consume it normally: they see standard sensor + location streams and behave the same way they would on the bike, no code change needed. And since the location comes from a real ride, adding the matching route lights up the route-based features like Climber too.

What it does:

• Reads FIT files from the Karoo's FitFiles/ folder (or a sideloaded one)
• Publishes Power / HR / Cadence / Speed through a single virtual sensor via karoo-ext, so consumer extensions pair to it just like real BLE/ANT+ hardware. Recorded distance drives Karoo's ride distance through the same hook real speed sensors use — so you can run a replay even without mocking GPS.
• Injects GPS via Android's mock-location framework, so Karoo OS sees position move along the recorded route
• Variable playback speed (1× / 2× / 5× / 10×) for fast iteration on a specific segment

New in v0.9.0-beta:

• A Karoo-native UI: pick a ride, then scrub a draggable timeline, drop bookmarks, and loop between two of them to re-run a segment
• Mock GPS is now scoped to an active replay — it only takes over while a replay is playing and releases when you exit, so you can leave the app selected as the mock-location app and still ride normally with real GPS
• Star favourites to pin the rides you test against

Built on karoo-ext. The single-sensor lifecycle follows the Karoo-KPower pattern (credit lockevod), and Tim Klemmer (awesome-karoo maintainer) pointed out several cleaner approaches along the way — thanks!

Repo: https://github.com/lgangitano/karoo-ride-replay
APK + Karoo 2 / Karoo 3 sideload instructions: https://github.com/lgangitano/karoo-ride-replay/releases/latest

Apache 2.0. v0.9.0-beta — feedback and bug reports welcome.