SageTube

A watch-first YouTube client for the desktop. Search, browse channels and playlists, follow subscriptions, and stream videos in an embedded mpv player — with the full yt-dlp download feature set inherited from YTSage.

Features

Watching

• 📺 Embedded mpv player (Wayland/X11/Windows/macOS) with quality selector, speed, volume, subtitles, fullscreen
• 🔍 In-app YouTube search with thumbnail card grid
• 📂 Channel browsing (Videos / Shorts / Live) and playlist views
• 🔔 Local subscriptions — no Google account needed — with an aggregated feed; optional real account feed via browser cookies
• ⏯️ Watch history with resume positions and a persistent play queue
• ⬇️ One click from any video card into the downloader

Downloading (from YTSage)

• Format table, audio extraction, subtitles, SponsorBlock, chapters, playlists, trimming, speed limits, proxies, cookies, custom yt-dlp commands, download history — see the upstream README

Install

pip install .
sagetube

Requires libmpv for playback (Arch: pacman -S mpv) — see Building. Without it the app works as a downloader.

Fork notes

SageTube is a fork of YTSage by oop7 (MIT). The internal package keeps the ytsage name so upstream fixes remain mergeable — see Tracking upstream. The fork also fixes a number of upstream bugs (unsafe partial-file cleanup, unverified binary updates, thread-safety issues, PATH corruption on Windows — see the git log).

License

MIT — see LICENSE.