git404hub

what is ride-recap fr?

ianmacomber/ride-recap — explained in plain English

Analysis updated 2026-05-18

6PythonAudience · vibe coderComplexity · 3/5Setup · moderate

tl;dr

Ride Recap turns hours of GoPro cycling footage and Garmin ride data into a short, AI-edited highlight video with ride stats burned in, for about four cents per ride.

vibe map

mindmap
  root((ride-recap))
    What it does
      GoPro plus Garmin fusion
      AI clip scoring
      Auto highlight reel
      Telemetry overlay
    Tech stack
      Python
      ffmpeg
      Gemini
      Streamlit
    Use cases
      Cycling highlight videos
      Ride data visualization
      Local model option
    Audience
      Cyclists
      Hobbyist creators

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Automatically turn hours of raw GoPro cycling footage into a 60-second highlight reel.

VIBE 2

Combine Garmin telemetry like power and heart rate with video to find the most exciting moments of a ride.

VIBE 3

Review and approve AI-selected highlight clips in a browser before the final video renders.

VIBE 4

Run the entire pipeline with a local vision model instead of a paid API for privacy or cost reasons.

what's the stack?

PythonffmpegGeminiStreamlit

how it stacks up fr

ianmacomber/ride-recapaclark4life/home-depot-crawlaetheria-labs1/storefront-skills
Stars666
LanguagePythonPythonPython
Last pushed2014-08-10
MaintenanceDormant
Setup difficultymoderatemoderateeasy
Complexity3/52/53/5
Audiencevibe coderdeveloperpm founder

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Python, ffmpeg, an AI provider API key (or a local model), plus your own GoPro and Garmin ride files.

The README does not state a license for this repository.

in plain english

Ride Recap takes hours of raw GoPro video footage from a bike ride, combines it with a Garmin data file that records speed, heart rate, power, and location for every second of the ride, and automatically produces a short 60-second highlight video with that ride data displayed on screen. The author built it because they ride most weekends and end up with hours of footage that nobody, including themselves, wants to sit through, but manually editing a highlight reel every time takes too much effort to bother with. The tool works by scoring every moment of the ride from several angles at once: the Garmin data flags exciting bursts like sprints or climbs, the Strava fitness app can flag well-known popular routes, and an AI vision model watches the actual video frames and rates how visually interesting each one is. An optional tool also lets a person manually mark their favorite moments. All of these signals get combined, favoring moments where multiple sources agree something is worth keeping, and the tool picks a set of clips spread out across the ride rather than clustering them all together. Running it costs about four cents in AI usage fees per ride and takes about ten minutes, using Google's Gemini AI model by default, though it can also work with OpenAI's models or a model run entirely on your own computer. After processing, a review tool opens in your browser showing short preview clips so you can approve or swap out selections before the final video is put together, or you can skip that step and let the tool decide everything on its own. Setup requires Python, the video tool ffmpeg, and an API key for whichever AI provider you choose. It is aimed at cyclists who record their rides with a GoPro camera and a Garmin bike computer and want an easy way to create a shareable highlight video without spending hours in video editing software.

prompts (copy fr)

prompt 1
Walk me through setting up ride-recap with my GoPro footage, Garmin .fit file, and a Gemini API key.
prompt 2
Explain how ride-recap combines telemetry, Strava data, and AI vision scoring to pick highlight clips.
prompt 3
How do I configure ride-recap to use a local vision model instead of Gemini or OpenAI?
prompt 4
Show me how to use the sample ride data to test ride-recap without my own GoPro footage.

Frequently asked questions

what is ride-recap fr?

Ride Recap turns hours of GoPro cycling footage and Garmin ride data into a short, AI-edited highlight video with ride stats burned in, for about four cents per ride.

What language is ride-recap written in?

Mainly Python. The stack also includes Python, ffmpeg, Gemini.

What license does ride-recap use?

The README does not state a license for this repository.

How hard is ride-recap to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ride-recap for?

Mainly vibe coder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.