explaingit

oop7/ytsage

Analysis updated 2026-07-03

3,667PythonAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A desktop app with a graphical interface for downloading YouTube videos and audio in multiple formats, with extras like SponsorBlock, subtitle embedding, and playlist selection.

Mindmap

mindmap
  root((YTSage))
    Core Features
      Video download
      Audio extraction
      Format selection
    Extra Features
      SponsorBlock
      Subtitles
      Playlist support
      Time trimming
    Setup
      pip install
      Pre-built installers
      FFmpeg bundled
    Platforms
      Windows
      macOS
      Linux
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Download a YouTube video in a specific resolution to your computer without using the command line.

USE CASE 2

Extract only the audio from a YouTube video and save it as an MP3 or AAC file automatically.

USE CASE 3

Download an entire YouTube playlist and pick only the videos you want, skipping sponsor segments.

USE CASE 4

Download a video trimmed to a specific time range, such as just a clip from minutes 2 to 5.

What is it built with?

PythonPySide6yt-dlpFFmpeg

How does it compare?

oop7/ytsagemarkuspfundstein/mcp-obsidiantextualize/rich-cli
Stars3,6673,6683,665
LanguagePythonPythonPython
Setup difficultyeasymoderateeasy
Complexity2/52/51/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

FFmpeg is needed for merging streams and format conversion, pre-built installers include it bundled.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

YTSage is a desktop application for downloading videos and audio from YouTube. It provides a graphical interface so you do not need to use a command line. Under the hood it runs yt-dlp, a well-maintained download tool, and wraps it in a window built with a Python library called PySide6. It works on Windows, macOS, and Linux. The core use is straightforward: paste a YouTube URL, pick a video quality or choose audio-only, and download. The app shows a table of all available formats for a video so you can compare resolutions, codecs, and file sizes before choosing. For audio, you can select the format (MP3, AAC, and others) and it will convert automatically. Beyond basic downloads, the app includes several additional features. SponsorBlock integration can skip or remove sponsor segments from videos automatically. Subtitles can be downloaded separately or merged directly into the video file. Playlists are supported, with a selector so you can choose specific videos from a playlist rather than downloading everything. You can also trim a video to a specific time range before downloading, set a download speed limit, use a proxy connection, and log in using browser cookies for age-restricted content. Installation is available through multiple routes. The simplest is a one-line pip install from PyPI, followed by typing the app name to launch it. Pre-built installers and portable executables are also available on the releases page for Windows, Linux, and macOS, including versions with FFmpeg already bundled. FFmpeg is a separate tool needed for merging audio and video streams and for format conversion. The README is available in 14 languages. The project is licensed under MIT.

Copy-paste prompts

Prompt 1
Show me how to install YTSage on Windows using pip and how to launch it for the first time.
Prompt 2
I want to download a YouTube video as an MP3 using YTSage. Walk me through selecting audio-only format and picking MP3 output.
Prompt 3
How do I use YTSage to download a YouTube playlist and select only specific videos from it?
Prompt 4
Show me how to enable SponsorBlock in YTSage so sponsor segments are automatically skipped when downloading a video.

Frequently asked questions

What is ytsage?

A desktop app with a graphical interface for downloading YouTube videos and audio in multiple formats, with extras like SponsorBlock, subtitle embedding, and playlist selection.

What language is ytsage written in?

Mainly Python. The stack also includes Python, PySide6, yt-dlp.

What license does ytsage use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is ytsage to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ytsage for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub oop7 on gitmyhub

Verify against the repo before relying on details.