runrazor 0.1.2

RunRazor: movement-analysis tools for stationary-camera footage

RunRazor

Tools for movement analysis from stationary-camera footage.

If you film yourself or someone else repeating a course past a fixed camera -- hill repeats, sprints, drills -- RunRazor turns that raw footage into usable clips. It uses the subject's GPS track to find each pass automatically, can crop and follow the subject so they stay framed, and lets you compare runs side by side or export the cuts straight to a video editor.

Command	What it does
runrazor	The main app: automatically cut a video using the subject's GPS track, review and tune the cut points, reframe, and export (see rrdocs runrazor)
rrreframe	Crop and follow a moving subject automatically so they stay framed (see rrdocs reframe)
rrcompare	Play two runs side by side, lined up in time, to compare them (see rrdocs compare)
rrtag	Mark matching points in two runs by hand so rrcompare can line them up (see rrdocs compare)
rrdocs	Open the bundled documentation in your browser

Environment

• Python 3.12
• ffmpeg and ffprobe on PATH (used for probing and cutting video)
• libmpv installed on the system for GUI video playback (the GUI still launches without it; see rrdocs runrazor)

Install

pip install runrazor

Documentation is bundled with the package; run rrdocs to open it in your browser (rrdocs reframe opens a specific page).

RunRazor

The GUI ties it all together: load a video and GPS track, review and tune the cut points against the footage, reframe, and export.

runrazor

See rrdocs runrazor for all options, hotkeys, time format, libmpv setup, and examples.

Reframe

Automatic subject tracking and reframing pipeline. Crops video from a stationary camera to follow a moving subject. You can use this without the RunRazor segmentation.

rrreframe input.mp4

You may get reasonable results without any additional arguments.

See rrdocs reframe for fine-tuning, deshake, horizon correction, 360 video input, interactive pinning, profile mode, and cache options.

Split-screen comparison

Side-by-side comparison of two ski runs (or one run against its own mirror), phase-locked turn-by-turn. It runs on Reframe outputs: each clip's trajectory sidecar (written by default) drives automatic turn-apex detection, and one clip plays at native speed while the other is retimed per turn segment to stay in sync.

rrreframe runA.mp4 --output a.mp4
rrreframe runB.mp4 --output b.mp4
rrcompare a.mp4 b.mp4 -o compare.mp4

The alignment is written to an editable JSON sidecar that you can hand-tweak and re-render. To compare against an external clip that was never reframed (or to fix wrong auto-detected turns), tag its apexes with rrtag clip.mp4. See rrdocs compare for turn pairing, mirroring, pane fit, retiming, manual tagging, and the alignment JSON.