YTSage: A Clean GUI Wrapper for yt-dlp with SponsorBlock and Subtitle Merging

If you've ever used yt-dlp from the command line, you know how powerful it is. But sometimes you just want a quick, visual way to download videos without remembering all those flags. That's where YTSage comes in.

YTSage is a PySide6 desktop application that wraps yt-dlp into a clean, user-friendly interface. It adds some clever extras like SponsorBlock integration (to skip sponsored segments automatically) and subtitle merging. No more juggling terminal commands for simple downloads.

What It Does

At its core, YTSage lets you paste a YouTube (or any yt-dlp supported) URL, choose your format and quality, and download. But the real value is in the details:

• SponsorBlock support – Automatically skip sponsored sections, intros, outros, and other flagged segments in downloaded videos.
• Subtitle merging – Download subtitles and burn them directly into the video file, or keep them as separate files.
• Format selection – Pick from available video+audio formats, or download just the audio.
• Queue management – Add multiple videos and let them download in sequence.

The GUI is built with PySide6, so it looks and feels native on Windows, macOS, and Linux. No web wrappers or Electron bloat here.

Why It’s Cool

Most yt-dlp GUIs either try to do too much or too little. YTSage hits a sweet spot. It doesn't try to replace the command line for power users, but it makes the 80% use case dead simple.

The SponsorBlock integration is the standout. If you download a lot of YouTube content for offline watching, having the sponsored segments automatically removed is a huge time saver. The subtitle merging is also handy for language learners or accessibility.

Under the hood, it's a relatively clean Python project. The code is straightforward enough that a dev could easily fork it, add custom features, or script around it.

How to Try It

You'll need Python 3.8+ installed. Then it's just:

git clone https://github.com/oop7/YTSage.git
cd YTSage
pip install -r requirements.txt
python main.py

That's it. The app will open and you can paste in your first URL.

Prebuilt binaries? Not yet, but the repo includes instructions for building with PyInstaller if you want a standalone executable.

Final Thoughts

YTSage isn't revolutionary, and it doesn't need to be. It's a well-executed, practical tool that solves a real problem: making yt-dlp accessible for quick downloads without the terminal overhead. If you're a developer who occasionally needs to grab YouTube content for testing, research, or personal use, this is a nice addition to your toolkit.

If you want to contribute, the repo is open for pull requests. The codebase is small enough to understand in an afternoon.

Found this on @githubprojects