██████╗ ███████╗███████╗██╗
██╔══██╗██╔════╝██╔════╝██║
██████╔╝█████╗  █████╗  ██║
██╔══██╗██╔══╝  ██╔══╝  ██║
██║  ██║███████╗███████╗███████╗
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄

🎬 download anything. keep what matters. 🎵

⚡ Get started ★ View on GitHub

🎛️Download modes

🎬
default
Video
Best quality MP4 with audio — no flags needed.
🎵
--audio
Audio only
Highest quality MP3 extracted from the source.
🎥
--video-only
Video only
MP4 with no audio track.
🎞️
--both
Both
MP4 and MP3 saved as separate files in one shot.

🚀Installation

1
Install FFmpeg
bash
# macOS
brew install ffmpeg

# Ubuntu / Debian
sudo apt install ffmpeg
2
Clone the repo
bash
git clone https://github.com/gio85/music-video-downloader.git
cd music-video-downloader
3
Create a virtual environment & install dependencies
bash
python3 -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt

📖Usage

🎬 download video (default)
python3 reel.py https://youtube.com/watch?v=...
🎵 audio only (MP3)
python3 reel.py --audio https://youtube.com/watch?v=...
🎥 video only (no audio)
python3 reel.py --video-only https://youtube.com/watch?v=...
🎞️ both video + audio as separate files
python3 reel.py --both https://youtube.com/watch?v=...
⚡ batch download + custom output folder
python3 reel.py --audio -o ~/Music https://url1 https://url2 https://url3

🛠️Tech stack

🐍
Python 3
Runtime. No exotic dependencies — just the standard library plus yt-dlp.
⬇️
Core download engine. Supports YouTube, SoundCloud, Vimeo, TikTok, and 1000+ sites.
🎞️
Handles audio extraction, format conversion, and stream merging.
⚠️
Responsible use only REEL is intended for downloading content you have the right to download — such as your own videos, Creative Commons licensed material, or content explicitly made available for download by its creator. Downloading copyrighted content without permission may violate the platform's terms of service and applicable copyright laws. You are solely responsible for how you use this tool.