A modern, feature-rich multi-platform video downloader with a beautiful web interface. Download videos in up to 4K quality, extract audio as MP3, or grab entire playlists with just one click.
View Demo • Features • Get Started • FAQ • Contribute
| Feature | Benefit |
|---|---|
| 🖥️ Web Interface | No command line needed - use your browser |
| ⚡ One-Click Setup | Just run run.bat - everything auto-configures |
| 🎬 Up to 4K Quality | Download videos in the highest available resolution |
| 🎵 MP3 Extraction | Convert videos to high-quality audio |
| 📺 Playlist Support | Download entire channels or playlists at once |
| 📋 Download Queue | Queue multiple downloads and manage in one place |
| 🔍 Video Discovery | Discover channel videos before downloading |
| 📂 Custom Path | Save files to any folder you choose |
| 🔄 Auto Updates | yt-dlp updates automatically |
| 🌐 Cross-Platform | Works on Windows, macOS, and Linux |
- ✅ Video Download - Download videos from 1700+ sites in up to 4K quality
- ✅ Multi-Platform Support - YouTube, TikTok, Facebook, Instagram, Twitter, and more
- ✅ Audio Extraction - Extract audio as high-quality MP3
- ✅ Quality Selection - Choose from 144p to 4K resolution
- ✅ Real-time Progress - Live download progress with speed indicator
- ✅ Download Queue - Queue multiple downloads and manage them in one place
- ✅ Channel/Playlist Discovery - Discover videos progressively before downloading
- ✅ Custom Download Path - Choose where to save your files
- ✅ Concurrent Downloads - Download multiple videos simultaneously (1-5)
- ✅ Modern UI - Sleek, responsive dark theme interface
- ✅ Auto Tool Check - Automatically detects if FFmpeg and yt-dlp are installed
- ✅ One-Click Run - Just double-click
run.batto start
Zen Downloader supports 1700+ websites including:
| Platform | Website |
|---|---|
| 🎬 YouTube | youtube.com, youtu.be |
| 🎵 TikTok | tiktok.com |
| facebook.com, fb.watch | |
| instagram.com | |
| 🐦 Twitter/X | twitter.com, x.com |
| reddit.com | |
| 🎥 Vimeo | vimeo.com |
| 📺 Dailymotion | dailymotion.com |
| 🎮 Twitch | twitch.tv |
| pinterest.com |
Plus 1700+ more! View full list
Zen Downloader features a powerful queue system for managing multiple downloads:
- 📋 Queue Panel - View all pending, downloading, and completed downloads
- ⚙️ Concurrent Downloads - Download up to 5 videos simultaneously
- 🎛️ Queue Controls - Start queue, clear completed, remove individual items
- 📊 Real-time Progress - See live progress for each download
- 🔄 Auto-retry - Failed downloads can be retried easily
For channels and playlists, use the Discover feature to:
- 🔍 Find Videos - Discover videos progressively as they're found
- 📝 Select Videos - Choose which videos to download with checkboxes
- 🎯 Set Limits - Limit how many videos to discover (1-500)
- ⏩ Real-time List - Videos appear in the list as they're discovered
:: Just double-click run.bat - that's it!
run.batThe run.bat will automatically:
- ✓ Check if Python, FFmpeg, and dependencies are installed
- ✓ Run setup.bat if anything is missing
- ✓ Start the server
- ✓ Open your browser to the app
# Install FFmpeg
# macOS:
brew install ffmpeg
# Linux (Ubuntu/Debian):
sudo apt install ffmpeg
# Install dependencies
pip install -r requirements.txt
pip install -U yt-dlp
# Run the server
python app.pyOpen http://localhost:5000 in your browser.
- Open the app - Browser opens to http://localhost:5000
- Paste URL - Paste any supported video URL
- Get Info - Click to fetch video details
- Select Quality - Choose your preferred resolution (144p to 4K)
- Add to Queue - Click "Add to Queue" to add to download queue
- Start - Go to Queue panel and click "Start"
- Paste URL - Paste playlist or channel URL
- Discover - Click "Discover Videos" to find all videos
- Select Videos - Check the videos you want to download
- Configure - Set quality and MP3 options
- Add to Queue - Click "Add Selected to Queue"
- Start - Go to Queue panel and click "Start"
| Option | Description |
|---|---|
| Video Quality | Select from available resolutions or "Best Quality" |
| MP3 Mode | Check "Download as MP3" to extract audio only |
| Download Path | Choose where to save your files |
| Max Videos | Limit how many videos to discover (for playlists) |
| Concurrent Downloads | Download multiple videos at once (1-5) |
A: This tool is for educational purposes. Please respect YouTube's Terms of Service and only download content you have the right to download.
A: Make sure FFmpeg is installed. The app automatically merges video and audio tracks. If issues persist, try selecting a different quality or use "Best" quality option.
A: Run pip install -U yt-dlp or simply run setup.bat again.
A: No, this tool only works with publicly available YouTube videos.
A: Yes! yt-dlp supports 1700+ websites. Check supported sites.
A: Files are downloaded to your browser's default download folder.
Just run run.bat - it will automatically install FFmpeg if needed.
Manual Install:
# Windows (with Chocolatey)
choco install ffmpeg
# macOS
brew install ffmpeg
# Linux
sudo apt install ffmpeg- Ensure the URL is correct
- Try updating yt-dlp:
pip install -U yt-dlp - Some videos may be region-locked or private
# Edit app.py to change port=5000 to port=8080| Method | Endpoint | Description |
|---|---|---|
| GET | / |
Main page |
| GET | /api/check |
Check if FFmpeg and yt-dlp are installed |
| POST | /api/info |
Get video/channel metadata |
| POST | /api/download |
Start download |
| GET | /api/progress/<task_id> |
Stream download progress |
| GET | /download/<task_id> |
Serve downloaded file |
| POST | /api/cleanup/<task_id> |
Cleanup temp files |
Contributions are welcome! Please read our Contributing Guidelines before submitting PRs.
- 🐛 Report bugs
- 💡 Suggest new features
- 📝 Improve documentation
- 💻 Submit code improvements
| Technology | Purpose |
|---|---|
| Flask | Web framework |
| yt-dlp | Video downloading |
| Tailwind CSS | Modern styling |
| FFmpeg | Media processing |
This project is licensed under the MIT License - see the LICENSE file for details.
This tool is for educational purposes only. Please respect YouTube's Terms of Service and only download content that you have the right to download. The developers are not responsible for any misuse of this software.
Star ⭐ this repo if you find it useful!
Made with ❤️ by Zen Downloader Team