Media Downloader - YouTube & TikTok
CalDownloader is a powerful command-line media downloader that supports downloading videos, playlists, and audio from YouTube and TikTok. It provides a user-friendly interface with multiple quality options and batch processing capabilities.
| Category | Feature | Description |
|---|---|---|
| 🎬 YouTube Support | Quality Options | Download videos in Best, 1080p, or 720p quality |
| Playlist Downloads | Download entire YouTube playlists automatically | |
| Audio Extraction | Convert videos to MP3 format (192kbps quality) | |
| Metadata Display | Shows video title, uploader, duration, and view count | |
| 📱 TikTok Support | Video Downloads | Download TikTok videos without watermark |
| Content Details | Displays uploader information and video details | |
| Rate Limiting | Built-in protection against API rate limits | |
| 🛠️ Core Features | Batch Processing | Download multiple URLs simultaneously |
| Progress Tracking | Real-time download progress with speed indicator | |
| File Management | View and clear downloaded files easily | |
| Cross-Platform | Compatible with Windows, macOS, and Linux | |
| User Interface | Colorful terminal interface for better user experience |
- Python 3.11 or higher
- pip (Python package manager)
- ffmpeg (optional but recommended for audio conversion)
# Clone the repository
git clone https://github.com/ricalnet/caldownloader.git
cd caldownloader
# Create and activate virtual environment
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Run the application
python3 main.py- Windows: Download from ffmpeg.org and add to PATH
- macOS:
brew install ffmpeg - Linux:
sudo apt install ffmpeg(Ubuntu/Debian) orsudo yum install ffmpeg(RHEL/CentOS)
1. Download Single URL - Download one video/audio
2. Download Batch URLs - Download multiple videos
3. YouTube Options - Specialized YouTube features
4. View Downloads - Browse downloaded files
5. Clear Downloads - Remove all downloaded files
6. Help - Show usage tips
7. Exit - Quit application
| Option | Quality | Format |
|---|---|---|
| Best Quality | Best available | MP4 |
| High Quality | 1080p | MP4 |
| Medium Quality | 720p | MP4 |
| Audio Only | MP3 192kbps | MP3 |
1. Select option 1 (Download Single URL)
2. Enter: https://www.youtube.com/watch?v=VIDEO_ID
3. Choose quality (1-4)
4. Wait for download to complete1. Select option 1 (Download Single URL)
2. Enter: https://www.youtube.com/playlist?list=PLAYLIST_ID
3. Choose quality (1-4)
4. All videos will be downloaded automatically1. Select option 2 (Download Batch URLs)
2. Enter URLs (one per line)
3. Press Enter on empty line to start
4. All videos will be processed sequentially- Download your own videos for backup
- Save reference videos for editing
- Extract audio for remixes or samples
- Convert YouTube videos to MP3
- Download entire music playlists
- Create offline music collections
- Save educational videos for offline viewing
- Archive YouTube playlists
- Download TikTok content for analysis
- Download content for repurposing
- Save TikTok videos for inspiration
- Create content libraries
- No data collection or tracking
- All processing done locally
- No third-party API keys required
- Open source and auditable
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
This project is licensed under the MIT License - see the LICENSE file for details.
- yt-dlp - The amazing downloader library
- All contributors and users of this tool