oop7

YTSage: Download YouTube Videos with yt-dlp

YTSage is a cross-platform YouTube downloader with a PySide6 desktop interface, built on yt-dlp. It handles video, audio, subtitles and playlists, with options such as SponsorBlock and video trimming.

View on GitHub Compare
Stars
4.7k
Forks
338
Stars, last 30 days
+56
Last commit
today
Contributors
6

Our take

Activeregular commits and releases

Health score

52/100

How it is scored
Activity
83
Community
20
Issues
61
Pull requests
43

+56 stars in the last 30 days

  • Releases more often than 83% of the projects we track

YTSage is an actively maintained, feature-rich yt-dlp interface, but its development is highly concentrated in one contributor.

Good fit if

  • You want a PySide6 desktop app rather than using yt-dlp directly from the command line.
  • You need options such as playlist selection, subtitle merging, SponsorBlock, or audio conversion.
  • You can use Python 3.11 or newer, or install a packaged build for your platform.

Look elsewhere if

  • You need a project with development effort broadly shared across contributors, since most code comes from one person.
  • You need a documented automated test suite; the supplied project facts report no tests.
  • Your workflow requires a platform or media source not supported by the available builds or yt-dlp.
All health signals
Last commit2026-11-01 (today)
Commits, last 90 days100+
Releases, last 12 months37 (latest v5.6.5-beta.1, 2026-10-23, pre-release)
Contributors6 (top contributor: 97% of commits)
Issues closed, last 90 days38 (typically closed in 20 days)
Pull requests merged, last 90 days1
Project age23 months

Checked on 2026-11-02 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

4,718

Forks

338

Change since Nov 14, 2026: +5 stars·0 forks

Overview

YTSage is a cross-platform YouTube downloader with a desktop interface built with PySide6 and powered by yt-dlp, the download engine. It gives users a graphical way to analyze links and download video or audio without building yt-dlp commands by hand.

It is aimed at people who want format and playlist selection, subtitle handling, and media options in one application. Generic Mode can also pass URLs for other sites supported by the installed yt-dlp version.

Key Features

  • Analyze video and playlist URLs, then select formats and quality.
  • Extract audio, convert audio formats, and normalize audio volume.
  • Select subtitles, merge them, and embed chapters, metadata, and thumbnails.
  • Use SponsorBlock to remove sponsored segments, or trim videos to specified time ranges.
  • Queue multiple downloads and retain the queue between launches.
  • Use cookies, proxies, and custom yt-dlp arguments for supported access scenarios.
  • Run on Windows, macOS, and Linux, with installers and a Python package; Docker Compose is another option.

Use Cases

  • YouTube viewers who prefer a desktop interface for choosing video quality, audio, and subtitles.
  • People saving selected entries from playlists or preparing several downloads in a queue.
  • Users extracting audio or saving subtitles, descriptions, and thumbnails alongside media.
  • Users of other yt-dlp-supported sites who need the optional Generic Mode.

What you need

Detected in the repository

  • Python >=3.11,<3.15 (from pyproject.toml)
  • A Compose file to run it with its related services
  • Automated checks on GitHub Actions

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install from PyPI with Python 3.11 or newer:

pip install ytsage
ytsage

For packaged installers, Docker Compose instructions, and configuration details, see the README.

Alternatives

  • Vividl: Vividl is Windows-only and supports multiple video sites, while YTSage is cross-platform and includes YouTube-focused features such as subtitles and trimming.
  • cobalt: cobalt offers a self-hostable web interface and API for supported public media links, rather than YTSage's PySide6 desktop app and YouTube-focused options.
  • yt-channel-downloader: yt-channel-downloader focuses on listing and selecting channel or playlist videos, while YTSage adds broader download options such as audio, subtitles, and trimming.
ProjectLanguageLicenseStarsStatus
YTSagePythonMIT4.7kActive
VividlC#BSD-3-Clause1.3kQuiet
cobaltSvelteAGPL-3.044.7kQuiet
yt-channel-downloaderPythonMIT517Active

Considerations

YTSage relies on yt-dlp for site support, so changes to supported sites and download behavior depend on that engine. FFmpeg is needed for merging separate high-quality video and audio streams and for some media processing; Deno is also documented as a runtime for yt-dlp plugins. The README describes packaged builds and dependency detection, but users running from source should account for these tools.

The project is active, with regular commits and releases and recent issue closures. However, contributor activity is concentrated heavily in one person, which is a maintenance continuity risk. The repository reports no tests, so teams adopting it should evaluate changes and packaging for their own workflows. The project uses the MIT license; review its terms when redistributing or incorporating it into other software.

Found this useful?

Share it with someone who would like YTSage.

Comparisons