⚡PyTube Downloader

---

🚀 Simple. Fast. Powerful YouTube Downloader.

PyTube Downloader is a modern, user-friendly application that makes downloading YouTube videos and playlists effortless. With support for multiple formats, quality levels (144p–8K), and simultaneous downloads, it gives you complete control over your YouTube media experience.

     

🖥️ User Interface Preview

---

✨ Features

• 🎞️ Playlist Downloading — Download entire playlists from a single URL.

• 🎚️ Format & Quality Selection — Choose from multiple formats (MP4, MP3, etc.) and qualities (144p–8K).

• 📊 Progress Tracking — Monitor downloads directly in the app.

• ⚡ Simultaneous Downloads — Save time with multiple concurrent downloads.

• ⚙️ Automatic Downloads with Predefined Settings — Set your preferred video quality, audio format, and download location once — PyTube will handle the rest.

• 🗂️ Dynamic Folder Organization — Automatically sorts files by playlist, quality, or type.

• 🌐 Multi-Language Support — Enjoy the app in your language:

  Language	Contributor
  English	-
  中文 (Chinese)
  සිංහල (Sinhala)
  தமிழ் (Tamil)

  💡 Help us improve existing translations or add new ones.

• ⌨️ Keyboard Shortcuts — Control the app easily with quick-access shortcut keys.

---

⚙️ Tech Stack

Category	Technologies
Language	Python
Libraries	tkinter, customtkinter, pytubefix, pillow, pyautogui, pystray, pyperclip. hPyT, win11toast, ctkchart
External Tool	FFmpeg (for video/audio processing)

---

🧭 Quick Start Guide

1️⃣ Clone the Repository

git clone https://github.com/Thisal-D/PyTube-Downloader.git
cd PyTube-Downloader

2️⃣ Install FFmpeg

• Download from FFmpeg.org

• Extract and copy ffmpeg.exe into:

  PyTube-Downloader/ffmpeg/
  

3️⃣ Install Dependencies

python dependencies_installer.py
python dependencies_updater.py

4️⃣ Run the Application

python main.py

5️⃣ Download Videos

1. Paste a YouTube video or playlist URL.
2. Choose Single Video or Playlist Mode.
3. Select your desired format and quality.
4. Click Download and track progress in real-time.
5. Find your downloaded files in the output folder — ready to enjoy!

---

📁 Project Structure

See Project Structure Guide for detailed folder and code layout information.

---

🌙 Dark Theme Preview

Screenshots

---

⭐ Star History

---

Excellent — your README already looks great! 👏 Below is an improved version of the “Contribution” section — rewritten to sound more inviting, professional, and community-driven. It highlights both code and non-code contributions (themes, translations, ideas, testing, docs, etc.) while keeping the same markdown tone as your file.

---

🤝 Contribution

We welcome all kinds of contributions — not just code! Whether you’re improving the UI, translating, enhancing themes, or helping refine documentation — your input makes PyTube Downloader better for everyone.

💡 Ways You Can Contribute

• 🧩 Code Improvements: Fix bugs, optimize performance, or suggest new features.
• 🌍 Language Contributions: Help us improve existing translations or add support for new languages.
• 🎨 Theme Contributions: Help us enhance current themes or design brand new ones.
• 🧠 Ideas & Feedback: Share feature suggestions or report issues on GitHub Issues.
• 🧾 Documentation & Guides: Improve readability, structure, or examples in the project documentation.

🛠️ Getting Started

1. Fork the repository.
2. Create a new branch for your changes.
3. Commit your improvements with clear messages.
4. Submit a pull request — we’ll review and merge it soon!

❤️ Every contribution, big or small, is appreciated. Let’s make PyTube Downloader even better — together!

---

📜 License

Licensed under the MIT License. See the LICENSE file for full details.

---

⚠️ Disclaimer

This application is intended for personal use only. Please respect YouTube’s Terms of Service and content creators’ rights when downloading videos.

---

👥 Contributors

Contributor	Profile
	youyu
	Navindu Pahasara
	Soorya Suraweera
	Fathima Asma

---

Made with ❤️