repo-reel
v0.1.1
Published
Turn any GitHub repo into a 25-second vertical social trailer. HTML in, MP4 out. Zero AI credits.
Maintainers
Readme
repo-reel
A 25-second vertical trailer for any GitHub repo. One command.
npx repo-reel vercel/next.jsThat's it. ~2 minutes → a 1080×1920 MP4 ready to post on X, LinkedIn, Reels, TikTok, Shorts.
Zero AI. Zero API keys. Zero signup. Runs locally.
What you get
| Beat | Shows |
|---|---|
| Cold open | Logo from your README + name + tagline |
| Stars | Counter 0 → real star count, radiating rays |
| What it does | Numbered bullets from your description, key words highlighted |
| Code scroll | First code block from your README, typed in live |
| Contributors | Top 5 avatars |
| Languages | GitHub-color-coded bar chart |
| CTA | github.com/owner/name + latest release |
Music + SFX baked in. Theme auto-detected from primary language + topics (cli / web / ml).
Install
brew install node ffmpeg gh jq
gh auth login
npx repo-reel <owner/name>Node 22+, FFmpeg, gh CLI, jq, curl.
Options
npx repo-reel <owner/name> # auto everything
npx repo-reel <owner/name> --theme ml # force cli|web|ml
npx repo-reel <owner/name> --quality draft # fast preview (~30s render)
npx repo-reel <owner/name> -o ./my-reel # custom output pathOutput: reel-<name>/renders/*.mp4 + a share caption in the terminal.
How it works
npx repo-reel owner/name
│
├─ gh api → stars, languages, contributors, README, logo, OG
├─ bash heuristics → theme + music + bullets from description
└─ HyperFrames → Puppeteer + FFmpeg → MP4No LLMs. No API keys. No cloud. Your own machine, every frame deterministic.
Customize
Want to hand-tune colors, rewrite bullets, reorder beats? Clone the repo and use it with Claude Code / Cursor / Codex — the /repo-reel skill walks the agent through it. See SKILL.md.
Credits
- Rendering: HyperFrames by HeyGen
- Music: Kevin MacLeod (incompetech.com) — CC-BY 3.0
License
Apache 2.0
