YouTube Video Downloader

YouTube Video Downloader is a versatile Python application that combines the power of yt-dlp with modern graphical and command-line interfaces. Download individual videos, entire playlists, or use batch mode with both GUI and CLI modes for maximum flexibility.

• 🎨 Modern GUI Interface - Intuitive PyQt5/PyQt6 desktop application
• 📹 Multiple Download Modes - Single video, playlist, or batch downloading
• 🎬 Format Selection - Choose video formats (MP4) or audio extraction (MP3)
• 📊 Quality Options - Select from best, medium, or lowest quality
• 🔄 Batch Downloading - Process multiple URLs from links.txt
• 📋 File Management - View, refresh, and delete downloaded files directly from the app
• ⚙️ Dark Mode - Easy-on-the-eyes dark theme
• 🌍 Cross-platform - Works on Windows, macOS, and Linux
• 🚀 Fast and Reliable - Powered by yt-dlp with automatic error handling
• 📝 Progress Tracking - Real-time download progress and status updates
• 🛠️ Customizable Settings - Configure download location and preferences via GUI

🎉 No Python installation needed! Just download and run!

👉 Download Latest Release 👈

Simply download YouTube_Downloader.exe and run it. That's it!

1. Go to Releases
2. Download YouTube_Downloader.exe from the latest release
3. Run the executable
4. Done! No dependencies needed

Automatic Updates:

• Download update.bat to the same folder as YouTube_Downloader.exe
• Run update.bat to check for and install updates
• The script will automatically:
  • Check GitHub for new versions
  • Download the latest version
  • Back up the old version
  • Install the new version
  • Launch the app

• Python 3.13+
• pip (Python package manager)
• FFmpeg (required for audio conversion and video processing)

Windows:

Download from FFmpeg Builds or use Chocolatey:

choco install ffmpeg

Verify installation: ffmpeg -version

macOS:

brew install ffmpeg

Linux (Ubuntu/Debian):

sudo apt update
sudo apt install ffmpeg

1. Clone the repository

   git clone https://github.com/TAskMAster339/YouTube_video_downloader.git
   cd YouTube_video_downloader

2. Create a virtual environment (recommended)

   # Windows
   python -m venv venv
   venv\Scripts\activate
   
   # macOS/Linux
   python3 -m venv venv
   source venv/bin/activate

3. Install dependencies

   pip install -r requirements.txt

   Key Dependencies:

   • yt-dlp - YouTube video downloader
   • PyQt5 or PyQt6 - GUI framework
   • pytest - Testing framework
   • pytest-mock - Mocking library for tests

1. Prepare your links file

   Create or edit the links.txt file in the project directory and add YouTube URLs. You can separate them with:

   • Newlines (one URL per line)
   • Spaces (multiple URLs on one line)

   Example 1 - Newline-separated:

   https://www.youtube.com/watch?v=dQw4w9WgXcQ
   https://www.youtube.com/watch?v=9bZkp7q19f0
   https://www.youtube.com/watch?v=kJQP7kiw5Fk
   

   Example 2 - Space-separated:

   https://www.youtube.com/watch?v=dQw4w9WgXcQ https://www.youtube.com/watch?v=9bZkp7q19f0
   

2. Run the script

   Choose the appropriate command for your operating system:

   Windows:

   py main.py

   macOS:

   python main.py

   Linux:

   python3 main.py

3. Find your videos

   Downloaded videos will be saved in the result/ directory.

# Windows
py src/app.py

# macOS/Linux
python3 src/app.py

• Drag & Drop URLs: Paste YouTube links into the drop area
• Select Format: Choose between MP4 (video) or MP3 (audio)
• Select Quality: Choose quality tier (1080p, 720p, 480p)
• Download: Click "Download All" to start
• Progress Tracking: See real-time progress for each video
• Folder Selection: Change download location anytime
• File Management: View and delete downloaded files

1. Single Video:

   • Paste a YouTube video URL into the input field
   • Select format (MP4 or MP3) and quality
   • Click "Download Video" or "Download Audio"
   • Monitor progress in the progress bar

2. Playlist:

   • Paste a YouTube playlist URL
   • Select format and quality
   • Click "Download Video" or "Download Audio"
   • App downloads all videos sequentially

3. Batch Processing:

   • Fill links.txt with multiple URLs (one per line or space-separated)
   • Click "Batch Download"
   • App processes all URLs and clears the file upon completion

The project automatically checks for yt-dlp updates and creates new releases on GitHub.

• Check the Releases page regularly
• Or use Обновить(приложение).bat script to auto-update

• Updates are triggered automatically when new yt-dlp versions are released
• GitHub Actions workflow handles building and releasing

YouTube_Video_Downloader/
├── src/
│   ├── app.py        # gui application
│   ├── local.py      # local yt-dlp usage
│   ├── main.py       # Main script
├── tests/            # Tests dir
├── links.txt         # Input file with video URLs
├── result/           # Downloaded videos directory
├── requirements.txt  # Python dependencies
└── README.md         # This file

You can modify the download settings by editing main.py. Common options include:

• Video quality - Choose resolution (e.g., 1080p, 720p, best)
• Audio only - Extract audio instead of video
• Subtitles - Download subtitles automatically
• Playlist support - Download entire playlists

Example configuration (in main.py):

ydl_opts = {
    'format': 'bestvideo+bestaudio/best',  # Best quality
    'outtmpl': 'result/%(title)s.%(ext)s',  # Output template
    'quiet': False,                          # Show progress
}

• Some videos have geographic restrictions
• Some videos are age-restricted or private
• Update yt-dlp to the latest version

• Check your internet connection
• Try a different video
• Update yt-dlp: pip install --upgrade yt-dlp

• YouTube might have changed their format
• This usually resolves itself when yt-dlp is updated

• Make sure FFmpeg is installed
• Add FFmpeg to your system PATH

Contributions are welcome! Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

# Clone your fork
git clone https://github.com/YOUR_USERNAME/YouTube_Video_Downloader.git

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install development dependencies
pip install -r requirements.txt
pip install pytest pytest-mock  # For testing

pytest tests/

This project is licensed under the MIT License - see the LICENSE file for details.

This tool is for educational and personal use only. Please respect YouTube's Terms of Service and copyright laws.

Do NOT use this tool to:

• Download copyrighted content without permission
• Violate YouTube's Terms of Service
• Redistribute downloaded content without permission

Always ensure you have the right to download and use any content.

• yt-dlp - The amazing library that makes this possible
• PyQt5 - For the GUI framework
• FFmpeg - For media processing
• All contributors who have helped improve this project

• GitHub Issues: Report bugs or request features
• GitHub Discussions: Ask questions or discuss ideas

If you find this project helpful, please consider:

• ⭐ Giving it a star on GitHub
• 🐛 Reporting bugs or suggesting improvements
• 🤝 Contributing code or documentation

Last Updated: October 25, 2025