beat-sync-reel
Generates Instagram Reels where product image cuts are synced to audio beats. Accepts audio as a local file, URL, or search query. Uses librosa for beat detection, FFmpeg Ken Burns for scene animation, and Pillow for text overlays. No AI video generation — fully free, fast, and scalable.
npx skills add gooseworks-ai/goose-skills --skill beat-sync-reel --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Beat-Sync Reel Generator Takes product images and a trending audio track, detects beats, and produces an Instagram Reel where every image cut lands exactly on a beat. Fast, free (no API credits), and scalable. --- ## Requirements - **Python 3** with `librosa` and `Pillow` packages - **FFmpeg** installed - **yt-dlp** installed (for URL/search audio input) --- ## Input The user provides: 1. **Audio** (required) — one of three formats: - **Local file path** — e.g. `/path/to/trending-audio.mp3` - **URL** — Instagram Reel, TikTok, or YouTube link. Download with: `yt-dlp -x --audio-format mp3 -o "audio.%(ext)s" "<URL>"` - **Audio name** — e.g. "Nashe Si Chadh Gayi". Web search for it, find a YouTube/SoundCloud source, download with yt-dlp. 2. **Product images** (required) — one of: - **List of image file paths** — local JPG/PNG files - **Product page URL** — scrape images using these methods in order until one works: 1. **Shopify JSON** — append `.json` to the product URL and extract image URLs from the response 2. **HTML scraping with referrer** — `curl` with `-H "Referer: <site-domain>"` and a browser user-agent, then parse `<img>` tags 3. **Chrome DevTools** — navigate to the page,
- Requirements
- Input
- Pipeline
- Step 1: Resolve Audio
- Step 2: Detect Beats
- Step 3: Classify & Filter Images
- Step 4: Create Ken Burns Scenes
- Step 5: Create End Card (Optional)
- Step 6: Concatenate Scenes
- Step 7: Add Audio
- Output
- Known Limitations
- Cost
- Example Usage
Just verify it exists and get duration ffprobe -v quiet -print_format json -show_format "audio.mp3" yt-dlp -x --audio-format mp3 -o "<workdir>/audio.%(ext)s" "<URL>" Zoom in center ffmpeg -y -loop 1 -i "image.jpg" \ Zoom out center Pan left to right Pan right to left Zoom in top-center (for torso/face crops) Pan up
What does the beat-sync-reel skill do?
Generates Instagram Reels where product image cuts are synced to audio beats. Accepts audio as a local file, URL, or search query. Uses librosa for beat detection, FFmpeg Ken Burns for scene animation, and Pillow for text overlays. No AI video generation — fully free, fast, and scalable.
How do I install it?
Run `npx skills add gooseworks-ai/goose-skills --skill beat-sync-reel --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From gooseworks-ai/goose-skills, a repository with 1,091 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.