- Rust 95.6%
- Shell 3.1%
- CSS 0.7%
- Dockerfile 0.6%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
- Flatpak manifest on GNOME 51, desktop file, metainfo and icons - Forgejo workflow builds and smoke-tests the Flatpak on amd64 and arm64, publishing dev-main from main and attaching bundles to v* releases - README, privacy policy and MIT licence - Player shortcuts work anywhere on the watch page - Download thumbnails held to 96 pixels - --smoke-test checks the GStreamer plugins playback needs Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LnueZzbjrAoDhtb8F3Tw6r |
||
| .forgejo/workflows | ||
| ci | ||
| data | ||
| packaging/flatpak | ||
| scripts | ||
| src | ||
| tests/fixtures | ||
| .gitignore | ||
| build.rs | ||
| Cargo.lock | ||
| Cargo.toml | ||
| LICENSE | ||
| PRIVACY.md | ||
| README.md | ||
BufferedTV for Linux
PeerTube is video hosting that nobody owns: thousands of independent servers, called instances, that host their own videos and share them with each other. BufferedTV lets you watch all of it. This is the Linux desktop version, the same app as on Apple TV, iPhone and iPad and Android, built with GTK 4, libadwaita and GStreamer, and packaged as a Flatpak.
What it does
- Find things worth watching. Trending, recently added, live now, top rated and videos local to your instance, with a full grid behind every shelf.
- Search the whole network. Searching one instance only reaches that server and the ones it follows, so BufferedTV searches every public instance through SepiaSearch by default. Narrow it to your own whenever you like.
- Sign in, or don't. Sign in to any instance for your subscriptions, playlists, Watch Later and history, with two-factor sign-in. Or browse without an account and sign in later.
- Watch it properly. Videos play at the best quality the instance published, not whatever the connection settles for. Quality, subtitles and speed are a click away, and full screen is a double-click or F. Where you got to syncs back to your instance, so you can pick up on another device. The media keys and your desktop's media controls work too.
- Have your say. Like or dislike, subscribe, save to Watch Later or any playlist, and read, write and reply to comments.
- Watch offline. Download a video from its page, with its subtitles, and it plays from your computer with no connection needed. Downloads are deleted 30 days after they finish unless you change that in Settings. An uploader's choice to turn downloads off is honoured.
- Subtitles in your language. Point it at a LibreTranslate server and it translates a video's subtitles while you watch.
- Your feed, your rules. Block an account or a whole server and it disappears everywhere, comments included. Report anything worse to the moderators.
- Parental controls. Sensitive videos are hidden until you choose otherwise. Set a parental PIN and changing that needs it, or choose Ask for the PIN to enter it before each sensitive video plays.
- Nothing is watching you. No analytics, no tracking, no advertising. The app has no server of its own behind it and reports nothing to us. See PRIVACY.md.
Installing
Download bufferedtv-<version>-linux-<arch>.flatpak for your computer
(amd64 for most PCs, arm64 for ARM machines) from the
releases, then:
flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak install --user bufferedtv-<version>-linux-<arch>.flatpak
Flatpak fetches the GNOME runtime the app needs from Flathub. Open BufferedTV
from your applications, or run flatpak run tv.buffered.BufferedTV.
Keyboard
| Key | |
|---|---|
| Space or K | Play and pause |
| Left and Right | Back and forward 5 seconds |
| J and L | Back and forward 10 seconds |
| F, or double-click | Full screen |
| Esc | Leave full screen |
| M | Mute |
| Ctrl+Q | Quit |
Building
Everything builds in containers, so all you need is Docker:
scripts/dev.sh cargo test # the tests, in the ci/dev container
scripts/dev.sh cargo build # a debug build
scripts/dev.sh scripts/smoke.sh # run it on a virtual display, with screenshots
scripts/flatpak-package.sh # the Flatpak, in dist/linux
On a Linux machine with GTK 4.14, libadwaita 1.7, GStreamer 1.24 (with the
gtk4paintablesink plugin) and Rust installed, cargo run works too.
The Forgejo workflow (.forgejo/workflows/build.yml) runs the tests and
builds the Flatpak on amd64 and arm64 for every push. A push to main
publishes both bundles as the rolling dev-main pre-release, and a v* tag
attaches them to that tag's release.
How it fits together
src/
├── api/ The PeerTube client (OAuth, token refresh), SepiaSearch,
│ LibreTranslate and the wire models
├── store/ The session, settings, blocklist, sensitive-content policy,
│ parental PIN, downloads and secrets
├── playback/ Which stream to play (resolver.rs) and the player
├── ui/ The window, sections, the watch page, channels, settings
├── vtt.rs WebVTT subtitles, drawn by the app so they can be translated
└── runtime.rs The Tokio runtime and the hand-off to GTK's main loop
The rules (which stream for which quality, what sensitive-content settings
hide, how blocks reach a video, how sign-ins refresh) are ported from the
Apple apps and behave the same. Network work runs on Tokio; runtime::spawn
hands each result back to GTK's main loop.
Playback is GStreamer's GstPlay drawing into a GtkPicture through
gtk4paintablesink. "Best available" pins the highest rendition, as on the
other platforms. Where an instance splits audio from video, it plays the
adaptive master with the HLS demuxer told to stay at the top.
Sign-ins, the translation API key and the parental PIN's salted hash go to the desktop's keyring through oo7 (the Secret Service, or the secret portal inside the Flatpak). On a desktop with no keyring they go to a file only you can read instead.
Thank you
PeerTube is made by Framasoft. PeerTube is a trademark of Framasoft; this app is not affiliated with, endorsed by, or supported by the PeerTube project.
Built with love by Ric Harvey and supported by SquareCows. MIT licensed: see LICENSE.