Overview
reeln is a free, open-source command-line toolkit that picks up where OBS leaves off. It takes your replay buffer recordings and turns them into organized highlight reels and 9:16 shorts, all powered by FFmpeg with no re-encoding.Built for streamers who capture youth sports, esports, or any live event —
reeln understands your sport's structure (periods, quarters, halves, innings) and organizes everything automatically.What it does
- Game workspace setup —
reeln game initcreates an organized directory for each game with sport-specific segment folders (e.g. period-1/, quarter-1/) - Segment highlights —
reeln game segment 1merges all replays from a period/quarter into a single highlight clip using FFmpeg concat (no re-encoding, instant) - Full-game highlight reel —
reeln game highlightscombines all segments into one video - 9:16 short rendering —
reeln render shortcreates vertical shorts from any clip, with optional player/goal overlays - Scoreboard integration [OBS Plugin] — the streamn-scoreboard plugin writes team names, scores, and game info to text files that OBS Text (GDI+) sources can read live
- Plugin architecture — extensible with lifecycle hooks and typed capability interfaces
Sport | Segments | Example Directory Structure |
| Hockey | 3 periods | period-1/, period-2/, period-3/ |
| Basketball | 4 quarters | quarter-1/ through quarter-4/ |
| Soccer / Football | 2 halves | half-1/, half-2/ |
| Baseball | 9 innings | inning-1/ through inning-9/ |
| Lacrosse | 4 quarters | quarter-1/ through quarter-4/ |
| Generic | configurable | works for any event |
Typical workflow:
- Stream your game with OBS, saving replay buffer clips as usual
reeln game init roseville mahtomedi --sport hockey— sets up the game folder- Drop replay clips into the appropriate period folders
reeln game segment 1— merges period 1 replays into a highlightreeln game highlights— combines all periods into one highlight reelreeln render short highlight.mkv— create a vertical short for social media
Requirements:
- Python 3.11+
- FFmpeg 5.0+
- Works on macOS, Linux, and Windows
Install:
python -m pip install reeln