edde746
41c6389cd4
Four regression flows, each run on a Pixel 7 and, where relevant, a real Android TV box. Discriminating — the baseline fails, HEAD passes: `07_sheet_back_dismiss` pins both halves of the hosted-sheet fix on touch: the barrier removes the rows behind it from the semantics tree, and one Back closes only the sheet while Settings stays the current route, including the nested per-library options page. It fails onc48cbf70, the commit before8e1904dd. `03_tv_library_focus` gains the same occlusion assertion for the TV sort sheet and fails there too. `08_track_choice_survives_pending_pass` picks a non-default audio and subtitle track, lets playback outlive the automatic pass's 5s attempt and 25s deadline, and asserts the choice is still selected. Ona56b9a3dthe audio reverts to the container's default. Both new flows onboard from a cleared install: the TV regressions in the same group leave "Force TV mode" enabled, and a remembered track selection would pre-select the rows under test. Coverage without a comparable baseline: `09_language_picker_locales` asserts the four new endonyms, switches to Turkish, reads root navigation labels from the generated locale, and restores English. The locales do not exist before 7677d159/100d7729, so there is nothing to fail against — this is forward coverage, not a reproduction. `10_tv_settings_navigation` runs on real Android TV hardware, which no existing flow covers: the rail layout a device reports on its own, the TV dialog path for Manage Libraries, the Apple-only Atmos gate staying closed on Android, and the D-pad-only route to the number spinner's accessibility labels, which a single tap would hide. It passes on either side of the range and is verified against both an empty server and one with a resume position, since rail order shifts with that. It does not assert the15b54e2erow density: that change is invisible to a semantics-tree driver, and a pixel `height` assertion would only hold for one DPR. It registers under a new `android-tv-device` group no workflow dispatches. No TV playback flow is included. Entering content on the TV Recommended view has no stable anchor: the accessibility `focused` flag sits on the hero backdrop rather than the rail card, and a resume position anywhere in the library pushes "Recently Added" below the fold and out of the semantics tree entirely. Search is not a way around it either — inputText does not reach the TV search field. Covering TV playback needs a testID on the rail card, not a cleverer selector. Also repairs three assertions that could never fail: `03_tv_library_focus` gated the sort sheet closing on `notVisible: "Sort by"`, but the header renders "Sort By" and Maestro selectors are case-sensitive regexes, so the wait returned immediately and the next D-pad press landed in the sheet's close animation. `open_codec_sample` matched a card's watch state as `watched|unwatched` only. A codec sample keeps a resume position once any earlier flow has played it, so the row announces "N percent watched" and the subflow stopped finding it on a fixture container that outlives one suite. `06_playback_recovery` tapped "Zulu Zone" out of the Recently Added rail, but every seeded alphabet title shares one dateadded, so which of them the rail returns is a tie-break. The flow only needs some playable movie.
Plezy
A modern client for Plex and Jellyfin on desktop, mobile, and TV. Built with Flutter for native performance and a clean interface.
Website · Screenshots · Download · Contributing · License
Download
| Platform | Download |
|---|---|
| Windows | Installer (x64, arm64) · Portable x64 · Portable arm64 |
| macOS | DMG (x64, arm64) |
| Linux x64 | .deb · .rpm · .pkg.tar.zst · portable tar.gz |
| Linux arm64 | .deb · .rpm · .pkg.tar.zst · portable tar.gz |
Package managers:
- Nix - Community package by @mio-19 and @MiniHarinn
- Homebrew (macOS):
brew tap edde746/plezy https://github.com/edde746/plezy brew install --cask plezy - AUR (Arch Linux) - Community maintained by @jianglai:
yay -S plezy-bin - WinGet (Windows):
winget install edde746.Plezy
Features
Browse & Discover
- Libraries, collections, and playlists
- Discover hub — Continue Watching, Next Up, trending, and recommendations
- Cross-server search
- Filtering, sorting, and alphabetical jump navigation
- Extras — trailers, deleted scenes, behind-the-scenes
Playback
- Wide codec support (HEVC, AV1, VP9, and more)
- HDR and Dolby Vision1
- Full ASS/SSA subtitles with customizable styling
- Online subtitle search & download2
- Audio & subtitle choices remembered per title
- Progress sync and resume
- Auto-play next episode with skip intro / skip credits
- Chapter navigation with thumbnail scrub previews
- Playback speed, audio sync offset, sleep timer
- Ambient lighting and GLSL shader presets3
- Picture-in-Picture4
- Refresh-rate matching5
- External player launch (VLC, MX Player, etc.)
Live TV & DVR
- Live TV channel browsing with favorites
- DVR support with EPG guide, recording rules, and scheduled recordings2
- Multi-server Live TV support where available
Downloads & Offline
- Download media for offline viewing
- Background queue with pause / resume
- Sync rules for automatic downloads
- Offline browsing with watch state sync-back on reconnect
Watch Together
- Synchronized playback with friends
- Real-time play / pause / seek sync
Integrations
- Discord Rich Presence6
- Trakt, MyAnimeList, AniList, and Simkl tracking & rating
- Plezy Remote — control desktop and TV from mobile
- Watch Next row
Platform & Customization
- Desktop, mobile, and TV — full D-pad, keyboard, and gamepad support
- Customizable keyboard shortcuts6
- Metadata and artwork editing
- Settings import/export
- Localized in English plus 14 translations
Building from Source
Prerequisites
- Flutter SDK 3.38.4+
- A Plex account or Jellyfin server with user credentials
Setup
git clone https://github.com/edde746/plezy.git
cd plezy
flutter pub get
scripts/codegen.sh
flutter run
Code Generation
After modifying model classes or other generated sources:
scripts/codegen.sh
After modifying translations:
dart run slang
Local Checks
scripts/ci_checks.sh
To install the same pre-commit checks locally:
scripts/setup_hooks.sh
Contributing
See CONTRIBUTING.md for development workflow, formatting, tests, and translation guidelines.
License
Plezy is licensed under GPL-3.0.
Acknowledgments
- Built with Flutter
- Supports Plex Media Server and Jellyfin
- Playback powered by mpv, MPVKit, Android ExoPlayer, libass-android, and libmpv-android