Our take
Activeregular commits and releases- 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 commit | 2026-11-01 (today) |
|---|---|
| Commits, last 90 days | 100+ |
| Releases, last 12 months | 37 (latest v5.6.5-beta.1, 2026-10-23, pre-release) |
| Contributors | 6 (top contributor: 97% of commits) |
| Issues closed, last 90 days | 38 (typically closed in 20 days) |
| Pull requests merged, last 90 days | 1 |
| Project age | 23 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.
Stars
4,718Forks
338Change 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.
| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| YTSage | Python | MIT | 4.7k | Active |
| Vividl | C# | BSD-3-Clause | 1.3k | Quiet |
| cobalt | Svelte | AGPL-3.0 | 44.7k | Quiet |
| yt-channel-downloader | Python | MIT | 517 | Active |
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.