minareel

Minareel - Facebook Reel Downloader

Download Facebook Reels from the command line. Captures video and audio streams and merges them into high-quality MP4 files.

Minareel uses Puppeteer to automate Chrome, intercepts network requests as the page loads, captures separate video and audio streams, then uses FFmpeg to merge them into a single MP4 file with H.264 video and AAC audio encoding.

Installation

Install globally to use anywhere with -g option:

npm install -g minareel

Quick Start

First time setup:

• Try to download your first reel - it will launch Chrome automatically
• Login to your Facebook account
• Close Chrome when done
• Your session is saved and reused automatically

Download reels:

# Single URL
minareel https://www.facebook.com/reel/123456789

# Multiple URLs
minareel https://www.facebook.com/reel/123456 https://www.facebook.com/reel/789012

# From text file
minareel urls.txt

# Custom output directory
minareel -d ./my_videos urls.txt

# Mix URLs and files
minareel https://www.facebook.com/reel/123456 urls.txt -d ./downloads

urls.txt format

Create a text file with one URL per line:

https://www.facebook.com/reel/1186616509878303
https://www.facebook.com/reel/890470184596539

Options

-d <directory>    Specify output directory (default: ./downloads)

Requirements

• Node.js 14 or higher
• Facebook account (authentication required for full-quality reels)

Output

Files are saved as {reel_id}.mp4 in the specified output directory. Progress is displayed in the terminal as downloads complete.

Things you can customize:

Run npm root -g to find where minareel's source code is at so you can fine-tune these options:

• THRESHOLD - Request count validation threshold (Expired or broken reels have lower requests so this threshold differentiates broken and valid reels)
• CONCURRENCY - Number of parallel downloads
• OUTPUT_DIR - where to save reels
• FFmpeg encoding settings (preset, CRF quality, bitrate)
• Chrome debugging port and user data directory

Feel free to fork, modify, and adapt to your needs!

Disclaimer

Educational project for learning browser automation and stream processing. Please respect content creators and only download your own content or content you have permission to use.

Links

• GitHub Repository
• Report Issues

License

MIT