Skip to content

acelest/ReelGrabber

Repository files navigation


ReelGrabber
ReelGrabber

Your favorite creators. No scroll. Just audio.

Less than a coffee. Unlimited reels, unlimited creators, forever.
→ reelgrabber.gumroad.com/l/reelgrabber-pro


     


Turn Instagram Reels into perfectly tagged, fully offline podcast albums. One command. No app. No algorithm. Just audio.


Quick Start

git clone https://github.com/acelest/ReelGrabber
cd ReelGrabber
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
playwright install firefox
./reelgrabber aliabdaal --collect
./reelgrabber aliabdaal --download
./reelgrabber aliabdaal --build-podcast
# → data/aliabdaal/aliabdaal_medley.mp3

ReelGrabber uses your existing Firefox session. No passwords, no API keys. First time: ./reelgrabber --login


Requirements

Tool macOS Linux Windows
yt-dlp brew install yt-dlp sudo apt install yt-dlp winget install yt-dlp
ffmpeg brew install ffmpeg sudo apt install ffmpeg choco install ffmpeg
Firefox Download Download Download

Usage

./reelgrabber <username> --collect            # index all reels
./reelgrabber <username> --download           # download .mp4 videos
./reelgrabber <username> --build-podcast      # merge into one crossfaded MP3
./reelgrabber <username> --build-podcast --split  # [PRO] individual MP3 per reel
./reelgrabber <username> --download --last 10 # last 10 reels only
./reelgrabber <username> --export csv         # export metadata to CSV
./reelgrabber --all --collect                 # [PRO] process all creators.yaml

# Download a single specific reel (no --collect needed)
./reelgrabber <username> --reel <url>
./reelgrabber <username> --reel <url> --build-podcast --split

--reel auto-fetches the creator's profile pic if missing, so cover art + badge are always embedded.


FREE vs PRO

FREE PRO
Reels per creator 15 Unlimited
Creators 1 Unlimited
Podcast medley
Split album (per-reel MP3s)
Smart updates (--update)
Custom metadata & cover
Price Free $5 one-time

Get PRO: reelgrabber.gumroad.com/l/reelgrabber-pro

./reelgrabber --activate YOUR-LICENSE-KEY
./reelgrabber --status

Output

data/<username>/
├── reels.json              # indexed shortcodes
├── metadata.json           # creator name & info
├── profile.jpg             # profile picture
├── <username>_medley.mp3   # final podcast
└── audio/
    ├── cover_final.jpg
    └── <username> - Reel 01.mp3   # [PRO] individual tracks

videos/<username>/          # downloaded .mp4 (safe to delete after build)
exports/                    # CSV exports

Why

Instagram is great. The feed isn't. The algorithm is designed for captivity. You open the app to learn and leave 45 minutes later having forgotten why you came.

ReelGrabber pulls your favorite creators out of the feed and puts them in your podcast app — offline, tagged, ready to listen while you walk, drive, or work.


Support