minareel
v1.0.4
Published
Download Facebook Reels from the command line. Captures video and audio streams and merges them into high-quality MP4 files.
Readme
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 minareelQuick 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 ./downloadsurls.txt format
Create a text file with one URL per line:
https://www.facebook.com/reel/1186616509878303
https://www.facebook.com/reel/890470184596539Options
-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 downloadsOUTPUT_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
License
MIT
