Skip to content

Repository files navigation

💿 Yikes YTD — The Ultimate YouTube Downloader

Yikes YTD is a professional, high-performance desktop application designed for seamless YouTube video and playlist extraction. Built with Python and CustomTkinter, it offers a stunning, modern interface that combines high-fidelity visuals with a powerful processing engine.

App Home


✨ Premium Features

🎨 State-of-the-Art UI/UX

  • Dynamic Theme Engine: Change accent colors in real-time. Whether it's Blue, Orange, or Green, the UI adapts instantly.
  • Adaptive Sidebar: A fully responsive sidebar that can collapse to save space without losing functionality.
  • Micro-Animations: Smooth transitions and hover effects for a premium feel.

⚡ Unmatched Performance

  • Powered by yt-dlp: The gold standard in video extraction, guaranteed to be fast and stable.
  • Multi-Format Mastery: Support for 4K, 2K, 1080p, 720p (MP4), high-bitrate MP3, WAV, M4A, and even GIF conversion.
  • Intelligent Quality Detection: Automatically verifies if your selected quality is available for a video and provides smart recommendations.
  • Advanced Playlist Management: Automatically detects playlists and organizes them into dedicated, sanitized folders.

📸 Exploring the Application

📥 The Download Hub

Experience a streamlined workflow for both individual videos and massive playlists.

![Single Video Selection](app-images/download-page-single-video-2.png)
<!-- slide -->
![Single Video Downloading](app-images/download-page-single-video-3.png)
<!-- slide -->
![Playlist Detected](app-images/download-page-playlist-1.png)
<!-- slide -->
![Playlist Resolution Choice](app-images/download-page-playlist-11.png)
<!-- slide -->
![Playlist Progress Tracking](app-images/download-page-playlist-22.png)

Tip

Yikes YTD handles the heavy lifting of metadata extraction and folder organization, ensuring your library stays perfectly organized.

🕒 History & Theming

Track your downloads and express your style with our live accent color system.

![Standard History](app-images/history-page-1.png)
<!-- slide -->
![Orange Theme Preview](app-images/history-page-orange-theme.png)
<!-- slide -->
![Collapsed Sidebar Mode](app-images/collapsed-sidebar-image-1.png)

⚙️ Page Gallery

Every corner of Yikes YTD is crafted for clarity and ease of use.

Page Description Visual
Settings Control your download path, theme accents, and app behavior. Settings
Help Integrated user guide covering all features and troubleshooting. Help
Feedback We value your voice. Send suggestions directly from the app. Feedback
About Version info, credits, and links to our community. About

🚀 Getting Started

Prerequisites

  • Python 3.10+ (Recommended for local development)
  • FFmpeg:
    • Linux: ✅ Bundled! No installation required.
    • Windows/macOS: Essential for merging high-quality streams. Download here.

Setup & Run

# Clone the repository
git clone https://github.com/WinterJackson/Yikes-YTD.git
cd Yikes-YTD

# Install dependencies
pip install -r requirements.txt

# Start Application
python main.py

Build a Standalone App

Generate a native executable for your OS using our optimized build config:

pip install pyinstaller
pyinstaller "Yikes YTD.spec"

The result will be located in the dist/ folder.


🤝 Acknowledgements

  • CustomTkinter: The foundation for our modern look.
  • yt-dlp: The engine that makes high-speed downloads possible.

© 2025 Winter Jackson - Built with ❤️ for the community.

About

A YouTube video downloader application. Can also download YouTube video full public playlists.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages