Homer
b3772ff484
Building, upstream tracking and YTSage's own README moved to the wiki; README points there. The history is not rewritten, unlike every other repository here. This one still merges from oop7/YTSage and a rewrite would change every commit id, which costs more than a clean history is worth in a fork. .github/ and readme-translations/ are upstream's files and stay where upstream put them. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
47 lines
1.8 KiB
Markdown
47 lines
1.8 KiB
Markdown
# 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](https://github.com/oop7/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](https://git.houmeres.sk/Houmeres/SageTube/wiki/Upstream-README)
|
|
|
|
## Install
|
|
|
|
```bash
|
|
pip install .
|
|
sagetube
|
|
```
|
|
|
|
Requires **libmpv** for playback (Arch: `pacman -S mpv`) — see
|
|
[Building](https://git.houmeres.sk/Houmeres/SageTube/wiki/Building). Without it the app works as a downloader.
|
|
|
|
## Fork notes
|
|
|
|
SageTube is a fork of [YTSage](https://github.com/oop7/YTSage) by
|
|
[oop7](https://github.com/oop7) (MIT). The internal package keeps the
|
|
`ytsage` name so upstream fixes remain mergeable — see
|
|
[Tracking upstream](https://git.houmeres.sk/Houmeres/SageTube/wiki/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](LICENSE).
|