SageTube
A watch-first desktop YouTube client with an embedded mpv player — a fork of
oop7/YTSage that keeps the upstream git history
and the internal ytsage package name so improvements can still be merged in.
Source: Houmeres/SageTube ·
what it is and how to install it is in the
README.
| Page |
What it is |
| Using it |
The tabs, the Feed's two modes, signing in with cookies, and the player's keys and mouse. |
| Building |
Requirements, building and running from source — including the mpv piece, without which the app is a downloader rather than a player. |
| Tracking-upstream |
How the fork relates to YTSage, and how a merge from upstream is done. |
| Upstream-README |
YTSage's own README, kept verbatim for reference. |
This repository is a fork, and it is treated as one
Its history has not been rewritten. Every other repository in this org had
its documentation removed from every commit on 2026-08-08; SageTube did not,
because rewriting changes every commit id and would end the ability to merge from
upstream. The documentation moved here in an ordinary commit instead, and the
history behind it is untouched and still shares ancestry with YTSage.
Two consequences worth knowing:
- The
vX.Y.Z tags on this repository are upstream's, not SageTube's. They
came with the history.
upstream is a real remote pointing at GitHub. Never push to it. A local
read-only clone of it lives at Github/YTSage in the same tree.
.github/ and readme-translations/ are upstream's files and are deliberately
left where they are — moving them would only create conflicts on the next merge.