BufferedTV for the Linux desktop: PeerTube, the video network nobody owns. GTK 4, libadwaita and GStreamer, packaged as a Flatpak.
  • Rust 95.6%
  • Shell 3.1%
  • CSS 0.7%
  • Dockerfile 0.6%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Ric Harvey a55ddf8160
All checks were successful
Build / Linux arm64 (push) Successful in 7m4s
Build / Linux amd64 (push) Successful in 9m59s
Build / Publish (push) Successful in 3s
Flatpak packaging, Forgejo CI, docs, and player fixes
- 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
2026-11-15 23:05:52 +00:00
.forgejo/workflows Flatpak packaging, Forgejo CI, docs, and player fixes 2026-11-15 23:05:52 +00:00
ci Flatpak packaging, Forgejo CI, docs, and player fixes 2026-11-15 23:05:52 +00:00
data The desktop app: GTK 4 and libadwaita, GStreamer playback 2026-11-15 20:40:46 +00:00
packaging/flatpak Flatpak packaging, Forgejo CI, docs, and player fixes 2026-11-15 23:05:52 +00:00
scripts Flatpak packaging, Forgejo CI, docs, and player fixes 2026-11-15 23:05:52 +00:00
src Flatpak packaging, Forgejo CI, docs, and player fixes 2026-11-15 23:05:52 +00:00
tests/fixtures The PeerTube client, stores and playback rules, ported from the Apple apps 2026-11-15 20:16:51 +00:00
.gitignore The PeerTube client, stores and playback rules, ported from the Apple apps 2026-11-15 20:16:51 +00:00
build.rs The desktop app: GTK 4 and libadwaita, GStreamer playback 2026-11-15 20:40:46 +00:00
Cargo.lock The desktop app: GTK 4 and libadwaita, GStreamer playback 2026-11-15 20:40:46 +00:00
Cargo.toml The desktop app: GTK 4 and libadwaita, GStreamer playback 2026-11-15 20:40:46 +00:00
LICENSE Flatpak packaging, Forgejo CI, docs, and player fixes 2026-11-15 23:05:52 +00:00
PRIVACY.md Flatpak packaging, Forgejo CI, docs, and player fixes 2026-11-15 23:05:52 +00:00
README.md Flatpak packaging, Forgejo CI, docs, and player fixes 2026-11-15 23:05:52 +00:00

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.