YTSage: yt-dlp's engine behind a PySide6 window anyone can use

A GUI where yt-dlp expects flags

YTSage's position is stated plainly, a modern YouTube downloader with a clean PySide6 interface, built with yt-dlp for reliable performance, meaning the battle tested download engine underneath and a desktop window on top. The design for audience is explicit in the why section, users who want a simple yet powerful downloader, with one click downloads for video, audio and subtitles as the headline, and the generic mode offered for sites yt-dlp supports beyond YouTube. The feature grid splits into three columns that map to user sophistication, core features like the format table and audio extraction, advanced ones like SponsorBlock and speed limiting, and extras like FFmpeg detection and custom commands, so a newcomer can stay in the first column forever and lose nothing essential.

SponsorBlock, chapters, and subtitle merging

The advanced column carries the features that separate this from a bare download button. SponsorBlock integration skips or marks sponsored segments using the community database, subtitle selection and merging writes chosen subtitle tracks into the output file rather than leaving sidecar files, and chapter integration embeds YouTube chapters into the result. Video section trimming cuts a range before download completes, audio normalization applies the EBU R128 loudness standard, and the save description and thumbnail option rounds out the archive-oriented behaviors. Each of these maps to a yt-dlp capability or an FFmpeg post-process, which is the honest description of the layer, YTSage surfaces options that exist in the engine but never got a GUI anywhere else.

Windows installers in four flavors

The Windows release table answers the two questions that actually vary, installation and FFmpeg. The standard installer is a double click setup wizard, an FFmpeg included variant exists for machines without FFmpeg, a portable version runs without installation, and a portable with FFmpeg build ships zipped. The four-way split is unusual care for a free tool, since the classic failure of GUI downloaders is a user stuck on a missing FFmpeg dependency with no guidance, and here the decision is made at download time rather than at first crash. The troubleshooting section continues that posture, and the project's GitHub sponsors page and Telegram channel round out the support surface.

Apple Silicon only, with a Python escape hatch

The macOS story has a boundary stated up front, the installers are natively built for Apple Silicon on M1 through M4 chips, and Intel Mac users are directed to the Python installation method instead rather than being offered a broken universal build. The Apple Silicon packages are a disk image to drag to Applications and a zipped application, with a specific troubleshooting entry for the Application is damaged error that macOS Gatekeeper produces on unsigned downloads. That combination, a narrow native target plus an explicit alternative path, is more honest than the usual universal installer claim, and the Python route below works on any macOS a recent Python supports.

Four Linux formats, Flathub included

Linux gets the widest packaging spread, a portable AppImage as the recommended option, a Debian package, an RPM package, and a Flatpak bundle on Flathub as io.github.oop7.ytsage. The AppImage path is two commands, chmod plus x on the file and running it, the deb path uses dpkg with an apt-get install -f suggestion to fix any missing dependencies, the rpm uses rpm -i, and the Flatpak install is a single flatpak command. The distribution breadth matters for the target audience, since the users who need a GUI downloader are exactly the ones who will not build from source, and having their distribution's native format available removes the last technical step.

PyPI, with FFmpeg setup help on Windows

The Python route requires Python 3.11 or newer and is one command:

pip install ytsage

with pip install --upgrade ytsage for updates, and the launch is the command name itself:

ytsage

URLs can be passed at launch, opening the application with a video or playlist URL prefilled and analyzed immediately, so the tool slots into keyboard-driven workflows despite being a GUI. The documented surprise is the Windows behavior, installing via pip automatically detects and helps set up FFmpeg, the assistance macOS and Linux users get from a separate FFmpeg installation guide maintained by the same author. The dependency list is small and current, PySide6, requests, pillow, packaging, markdown and loguru, with Python versions supported up to 3.14, and the source route for developers is clone, uv pip install or pip install, then python -m ytsage.main.

Sixteen readmes and a rapid release rhythm

The localization investment is the largest visible signal of the audience, the README ships in sixteen languages from Arabic and Persian through Korean, Turkish and Chinese, maintained as separate files in a translations directory. Development moves quickly, v5.5.3-beta.1 in early September 2026, v5.5.6-beta.1 mid-month, and v5.5.6 stable on 2026-09-18, with the repository pushed 2026-09-27, showing beta channels feeding into stable tags on a roughly monthly cadence. A version channel selection feature in the app itself lets users choose stable or beta tracks, matching the release structure, and the built-in updater tab plus automatic yt-dlp updating keep the engine current, which matters because YouTube changes break old downloaders faster than anything else.

Editorial conclusion

Use YTSage when the goal is downloading videos without learning yt-dlp's command line, since its format table, playlist selector and subtitle merging cover the common cases through a desktop interface, and the generic mode extends the same window to other sites yt-dlp supports. Prefer the yt-dlp CLI directly for scripting and batch pipelines, a GUI is not the right tool there. Before installing, pick the installer variant matching your system, the FFmpeg-included builds for machines without FFmpeg and the portable builds for no-install use, note the macOS builds are Apple Silicon only with Intel users directed to the Python path, and check the release channel options if you want stable rather than beta updates.

Frequently asked questions

Official sources

1. Issues
2. License: MIT
3. oop7/YTSage on GitHub
4. README
5. Releases