v5.5.1
Two regressions from 5.5.0, both mine. Fullscreen became a state of the main window, which is what stopped it destroying the player's GL context -- but the window's geometry is saved on exit and restoreGeometry() replays the state it was saved with. Quitting while fullscreen therefore brought the app back fullscreen: no title bar, no close button, and nothing able to leave it, because the player's F and Escape are scoped to the player and the Watch tab need not even be visible. Fullscreen is no longer restored at startup, it is left before the geometry is saved, and F11/Escape are now window-level shortcuts so there is always a way out. The controller also trusts the window rather than its own flag, so a fullscreen it did not set is still escapable. "Sign in with cookies" and the account button both call show_cookie_login_dialog, which selects the Cookies tab by index before showing the dialog. CustomOptionsDialog builds its tabs on SmoothTabWidget, which stands in for a QTabWidget and says so in its docstring, but implemented only set_current_index -- so setCurrentIndex raised and the dialog never opened. That line had never run before: the method had no callers until 5.5.0 wired it up. SmoothTabWidget now provides the Qt-compatible API it claimed. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
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.