Skip to main content

A GUI YouTube downloader powered by yt-dlp

Project description

๐ŸŽฌ YTGet โ€” Cross-Platform YouTube Downloader

YTGet GUI is a modern, lightweight, and user-friendly desktop application built with Python and PySide6.
Powered by yt-dlp, it makes downloading YouTube videos, playlists, and music simple and efficient.

  • ๐Ÿ–ฅ๏ธ Cross-Platform: Runs seamlessly on Windows, macOS, and Linux.
  • ๐Ÿ“ฆ Standalone: Each release comes with all dependencies bundled, so it works right out of the box.
  • โšก Optimized & Stable: Designed for smooth performance with smart resource handling, and built-in update management.
  • ๐ŸŽต Versatile: Supports full videos, playlists, and music downloads in multiple formats.

Whether youโ€™re grabbing a single clip or archiving an entire channel, YTGet delivers a polished and seamless experience on every operating system.


๐Ÿ“Š Repository Stats

๐ŸŒŸ Community

GitHub repo stars GitHub forks GitHub watchers

๐Ÿ› Issues & ๐Ÿ”€ Pull Requests

GitHub issues GitHub closed issues GitHub pull requests GitHub closed PRs

๐Ÿ“ฅ Downloads

GitHub all releases GitHub release (latest by date)

๐Ÿ’ป Codebase

GitHub repo size GitHub code size in bytes GitHub language count GitHub top language

โฑ๏ธ Activity

GitHub last commit GitHub commit activity


โ˜„๏ธ How to Install

๐ŸชŸ Windows

  1. Download the latest YTGet-Windows.zip release.
  2. Extract the contents.
  3. Run YTGet.exe.

๐Ÿง Linux

  1. Install required dependencies:
sudo apt-get update && sudo apt-get install -y libxcb-cursor0 libxcb-xinerama0 libxcb-xinput0 libxcb-xfixes0 libxcb-shape0 libxcb-render-util0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-randr0 libxcb-render0 libxcb-shm0 libxcb-sync1 libxcb-util1 libxcb-xkb1
  1. Download the latest YTGet-Linux.tar.gz release.
  2. Extract the contents.
tar -xzf YTGet-Linux.tar.gz
  1. Make it executable and launch:
chmod +x YTGet
./YTGet

๐ŸŽ macOS

  1. Download the latest YTGet-macOS.tar.gz release.
  2. In Terminal, run:
tar -xzf YTGet-macOS.tar.gz

This will produce a YTGet.app bundle in your current directory.

  1. Remove Quarantine Flag If you see โ€œcannot be opened because Apple cannot check it for malicious software,โ€ you need to strip the quarantine attribute:
xattr -d com.apple.quarantine YTGet.app

This lets macOS trust your app without popping security dialogs every launch.

  1. Set Executable Permission
chmod +x YTGet.app/Contents/MacOS/YTGet
  1. Move to Applications (Optional)

For a cleaner setup, drag YTGet.app into your /Applications folder or run:

mv YTGet.app /Applications/
  1. Launch YTGet

Choose one:

  • From Finder: double-click /Applications/YTGet.app.
  • From Terminal:
    open /Applications/YTGet.app
    
  • Or run the binary directly:
    /Applications/YTGet.app/Contents/MacOS/YTGet
    

๐Ÿ PyPI Installation

YTGet GUI depends on FFmpeg to process and convert media. Follow these steps to get everything up and running:

1๏ธโƒฃ Install YTGet GUI

pip install ytget-gui

2๏ธโƒฃ Set Up FFmpeg

Choose one of the two methods below:

2.1 Add FFmpeg to Your PATH (Recommended)

  • Download the latest FFmpeg build for your platform from this Link.

  • Extract the archive.

  • Add the bin/ directory to your system PATH:

    On Windows: update Environment Variables โ†’ Path.

    On macOS/Linux: edit ~/.bashrc or ~/.zshrc with

    export PATH="/path/to/ffmpeg/bin:$PATH"
    
  • Verify installation:

    ffmpeg -version
    

2.2 Copy Binaries into the YTGet Folder (Alternative)

  • Download the static FFmpeg binaries for your OS.

  • Copy ffmpeg (or ffmpeg.exe) and ffprobe (or ffprobe.exe) into the same directory where the ytget-gui executable lives.

๐Ÿ”„ How to Update (PyPI version)

To upgrade your PyPI installation to the latest release:

pip install --upgrade ytget-gui

This command fetches and installs the newest version, replacing your current one automatically.

โœจ Extra Tips You Might Find Useful

  • On macOS, you can also use Homebrew:
brew install ffmpeg
  • On Debian/Ubuntu:
sudo apt update && sudo apt install ffmpeg

โœจ Features

๐Ÿ–ฅ๏ธ Interface

  • ๐ŸŽฏ Clean Qt GUI โ€” Intuitive layout with dark-friendly visuals.
  • ๐Ÿ›‘ Cancel Anytime โ€” Gracefully stop downloads at any moment.
  • ๐Ÿ”’ Offline Capable โ€” No Python installation required.

๐Ÿ“ฅ Download Options

  • ๐Ÿ“น Multiple Formats โ€” Download videos from 480p up to 8K.
  • ๐ŸŽต MP3 Mode โ€” High-quality audio extraction with embedded thumbnails & metadata.
  • ๐Ÿ“„ Subtitles โ€” Auto-fetch subtitles (multi-language).
  • ๐Ÿ“‚ Playlist Support โ€” Download entire playlists in audio/video mode.

๐Ÿ”ง Advanced Features

  • โš™๏ธ Persistent Settings โ€” All settings saved to config.json.
  • ๐Ÿš€ Improved Playlist Support โ€” Reverse order, select items, archive tracking.
  • โœ‚๏ธ Clip Extraction โ€” Download video portions by start/end time.
  • โญ๏ธ SponsorBlock โ€” Skip sponsored content, intros, and outros.
  • ๐Ÿงฉ Chapters Handling โ€” Embed or split videos by chapters.
  • ๐ŸŽผ YouTube Music Metadata โ€” Accurate music info and album data.

๐Ÿ›  Functionality

  • ๐ŸŒ Proxy Support โ€” Configure proxies for downloads.
  • ๐Ÿ“… Date Filter โ€” Download videos uploaded after a specified date.
  • ๐Ÿงช Custom FFmpeg Args โ€” Add advanced arguments for power users.
  • ๐Ÿ”Š Audio Normalization โ€” Uniform volume for all downloads.
  • ๐Ÿ—ƒ Channel Organization โ€” Auto-sort videos into uploader folders.
  • โšก Performance Enhancements โ€” Smart rate limiting and retry logic.

๐Ÿ–ผ Screenshots


๐Ÿงฐ How to Use

  1. โ–ถ๏ธ Launch YTGet.
  2. ๐Ÿ”— Paste a YouTube URL.
  3. ๐ŸŽš๏ธ Select format (e.g., 1080p MKV or MP3).
  4. โฌ‡๏ธ Click โž• Add to Queue.
  5. โฌ‡๏ธ Click โ–ถ๏ธ Start Queue.

๐Ÿ“ Output

  • โœ… Clean filenames: %(title)s.ext
  • ๐ŸŽต Audio downloads include:
    • Embedded album art
    • Metadata tags (artist, title, etc.)

๐Ÿงฉ Format Options

Format Description
๐ŸŽž๏ธ 480pโ€“8K MKV, MP4, WebM video with merged best audio
๐ŸŽต FLAC Audio High-quality audio with tags & thumbnails
๐ŸŽต MP3 Audio High-quality audio with tags & thumbnails
๐Ÿ“ƒ Playlist MP3 Batch audio extraction from playlists

๐Ÿ”’ Cookies Support

For age-restricted or private content:

  1. Export cookies using Get cookies.txt extension.
  2. Place the file in _internal/cookies.txt.

โš™๏ธ Requirements

  • โœ… No installation โ€” just unzip and run.
  • ๐ŸชŸ Windows 10+ (64-bit).

๐Ÿ”ง Development Setup

Prerequisites

Setup

# Clone the repo
git clone https://github.com/ErfanNamira/ytget-gui.git

# Navigate to project
cd ytget-gui

# Create & activate virtual environment
python -m venv venv
# Linux/Mac
source venv/bin/activate
# Windows
venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run app
python -m ytget_gui

๐Ÿค Contribution Guide

  1. Fork & clone the repo

  2. Create a feature branch: git checkout -b my-feature

  3. Commit & push: git commit -m "msg" && git push origin my-feature

  4. Open a Pull Request


๐Ÿ“„ License

This project is licensed under the MIT License. See the LICENSE file for full details.


๐Ÿ“ฆ Download

๐Ÿ‘‰ Latest Release (.zip)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ytget_gui-2.4.7.2.tar.gz (232.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ytget_gui-2.4.7.2-py3-none-any.whl (234.5 kB view details)

Uploaded Python 3

File details

Details for the file ytget_gui-2.4.7.2.tar.gz.

File metadata

  • Download URL: ytget_gui-2.4.7.2.tar.gz
  • Upload date:
  • Size: 232.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for ytget_gui-2.4.7.2.tar.gz
Algorithm Hash digest
SHA256 f92316f57c4b527d839402955043f72471223d7b95497701bb4a697e3e539dda
MD5 e4964458e9892d21936bdd6301a772cf
BLAKE2b-256 32899ecbf465a8201c429eae52cb15a01eebd3bee7f2e16bfc3c56ab1a251683

See more details on using hashes here.

File details

Details for the file ytget_gui-2.4.7.2-py3-none-any.whl.

File metadata

  • Download URL: ytget_gui-2.4.7.2-py3-none-any.whl
  • Upload date:
  • Size: 234.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for ytget_gui-2.4.7.2-py3-none-any.whl
Algorithm Hash digest
SHA256 06dd8c3c7956214224ed0236505ae94c3b3df5d67d958d242c626b9f449827f9
MD5 062198d61f58c18d4b74e08d9fda9648
BLAKE2b-256 b69bc8e76301b53220c459ba1ad628873e03f5e3df059d0a2d7e35ec396fe9cf

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page