edde746
1995fc6b75
Resuming or seeking a large MKV on the Android FFmpeg demux path buffered for minutes with no error and no fallback. The cause was the seam, not the container: libavformat's demuxers own their seeking — end-of-file index, back to the header, binary search — while media3's Extractor is forward only, so every backward jump had to abort the in-flight libavformat call with a synthetic IO error and replay the whole open. matroskadec attempts its deferred Cues parse exactly once per context, so that abort burned the index for the session and every later seek fell back to libavformat's linear generic scan, reading the file up to the target. That protocol had produced a bug of this shape repeatedly (a NULL deref resuming find_stream_info across an abort, a use-after-free on fallback teardown, matroskadec resync skipping the keyframe cluster) and it was held together by four empirical retry budgets whose exhaustion degraded silently — which is why #2096 looked like an unbounded spinner instead of an error. Give libavformat what it requires instead. FfmpegRandomAccessSource serves any absolute position from a second DataSource built by the same factory media3 uses, cloning the DataSpec media3 opened for the item so Cronet, download caches, SAF and per-item request headers still apply. Reads that the loader's ExtractorInput can serve still go through it, so sample delivery keeps feeding media3's byte accounting, back-pressure and load-error policy; the extractor nudges the loader to follow the demuxer with one RESULT_SEEK, which is an optimization that can never stall playback because the read succeeds either way. Deleted with the protocol: the synthetic AVERROR_NEED_SEEK unwind, the 24 MB replay cache, the Cues priming seek and its read guard, the sticky AVIO error clearing, and all four budgets (seekAttempts, stickyRecovers, MAX_RECONCILES, MAX_OPEN_LOADER_ROUND_TRIPS). Opens run straight through, seeks are one avformat_seek_file on the loader thread, and an IO failure is an IOException that reaches media3's retry policy instead of a silent degradation. The demuxer is now the only component that resolves seeks, so the extractor's sample-derived seek index is gone too. Verified on a SEI Robotics Android TV box against Jellyfin: the DV P8.1 28.4 GB MKV resume that started at a 4m28s spinner opens in 1.1 s and resolves its seek in one call, a mid-playback scrub resolves in 1 ms from the in-memory index, a 2 GB MKV resume opens in 0.5 s, fresh playback needs no index read at all, and MP4/AVI still open and deliver. New coverage: FfmpegRandomAccessSourceTest pins the read/reopen contract, and FfmpegExtractorSeekTest asserts on-device that a cued seek lands on target without walking the file and that a cueless file still reaches it. close #2096
Plezy
A modern client for Plex, Jellyfin, and Emby on desktop, mobile, and TV. Built with Flutter for native performance and a clean interface.
Website · Screenshots · Download · Contributing · License
Download
| Platform | Download |
|---|---|
| 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 - Pacman (Arch Linux) - Official package:
sudo pacman -S plezy - WinGet (Windows):
winget install edde746.Plezy
Features
Browse & Discover
- Libraries, collections, and playlists — video and audio
- Discover hub — Continue Watching, Next Up, trending, and recommendations
- Cross-server search across every connected Plex, Jellyfin, and Emby server
- Filtering, sorting, and alphabetical jump navigation
- Folder browsing and folder playback — home-video libraries open in folder view
- Resolution, HDR/Dolby Vision, and audio-format badges on cards and detail pages
- Favorites and unwatched library filters1
- Extras — trailers, deleted scenes, behind-the-scenes
Explore & Requests
- Explore tab — watchlist, trending, popular, and recommendation rows from Plex Discover2 , Trakt, MyAnimeList, AniList, Simkl, and Seerr3
- Search any connected catalog source
- Catalog titles matched back to your own libraries by external ID
- Seerr — request movies and shows with per-season, 4K, and advanced destination options, and see request status inline
- Watchlist sync — add and remove titles on Plex, Trakt, MyAnimeList, AniList, and Simkl from anywhere in the app
Playback
- Wide codec support (HEVC, AV1, VP9, and more)
- HDR and Dolby Vision4
- Direct play, or transcode presets from 240p/320 kbps to 1080p/20 Mbps
- Multi-version switching with per-version file details
- Full ASS/SSA subtitles with customizable styling
- Online subtitle search & download2
- Audio & subtitle choices remembered per title, or follow the server's per-episode selections
- Progress sync and resume
- Auto-play next episode with skip intro / skip credits
- Chapter navigation with thumbnail scrub previews
- Playback speed from 0.25x to 8x, audio sync offset, sleep timer (fixed durations or end of video)
- Video zoom 50-200% with pinch, presets, and hotkeys
- Audio passthrough5 , stereo downmix with center-channel boost, and loudness normalization
- File Info sheet — every version, file, and stream the server reports
- Ambient lighting and GLSL shader presets6
- Picture-in-Picture7
- Refresh-rate matching8
- External player launch (VLC, MX Player, etc.) with progress sync back9
Music
- Music libraries — artist, album, and track browsing with square artwork
- Album and artist screens with play, shuffle, and Instant Mix
- Gapless playback with a full play queue — reorder, remove, play next, add to queue
- Now Playing with synced lyrics10 , persistent mini-player, and sleep timer
- Background playback with lock-screen, media-key, and notification controls11
- Offline playback of downloaded albums and tracks
- Streaming quality presets — Original, 320, 192, or 128 kbps
Live TV & DVR
- Live TV channel browsing, tuning, and favorites
- EPG guide with What's On and per-show schedules
- DVR recording rules, scheduled recordings, and a rememberable recording target library2
- Multi-server Live TV support where available
Downloads & Offline
- Download movies, shows, and music for offline playback12
- Background queue with pause / resume
- Sync rules for automatic downloads, with per-show "Include Specials"
- Offline browsing with watch state sync-back on reconnect
Watch Together
- Synchronized playback with friends
- Real-time play / pause / seek sync
Integrations
- Discord Rich Presence13
- Trakt, MyAnimeList, AniList, and Simkl — ratings, watched sync, and real-time scrobbling14
- Plezy Remote — control desktop and TV from mobile
- Watch Next row and tvOS Top Shelf15
Platform & Customization
- Desktop, mobile, and TV — full D-pad, keyboard, and gamepad support
- Multiple servers at once — Plex, Jellyfin, and Emby side by side
- Profiles with per-profile downloads, watch state, and settings; Plex Home switching with PIN
- Jellyfin and Emby local-server discovery and multiple URLs per server; Quick Connect sign-in16
- TV layout options — corner spotlight backdrop, full-card artwork, and Force TV mode on desktop
- Customizable keyboard shortcuts13
- Metadata and artwork editing
- Settings import/export
- Localized in English plus 21 translations
Building from Source
Prerequisites
- Flutter SDK 3.47.0+
- A Plex account, or a Jellyfin or Emby 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
End-to-end tests (Android emulator plus a Dockerized Jellyfin fixture):
python3 scripts/maestro/run_maestro.py basic
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, Jellyfin, and Emby
- Playback powered by mpv, MPVKit, Android ExoPlayer, libass-android, and libmpv-android
-
Jellyfin and Emby only. ↩︎
-
Plex only. ↩︎
-
Requires connecting the service under Settings > Services. ↩︎
-
In-app HDR toggle on Windows, macOS, iOS, tvOS, and Linux — Linux needs a colour-managed Wayland compositor. Dolby Vision on Android and Apple TV. ↩︎
-
Desktop, Android TV, and Apple TV. ↩︎
-
Requires the mpv player backend — unavailable on iOS and tvOS, and Android defaults to ExoPlayer. ↩︎
-
Android, iOS, and macOS — not on Android TV or Apple TV. ↩︎
-
Windows, Android, and tvOS. ↩︎
-
Progress sync on Android. ↩︎
-
Where your server provides lyrics. ↩︎
-
tvOS pauses music when the app is backgrounded. ↩︎
-
Not available on tvOS. ↩︎
-
Desktop only. ↩︎
-
Real-time scrobbling on Trakt and Simkl; MyAnimeList and AniList update on completion. ↩︎
-
Android TV / Fire TV and tvOS. ↩︎
-
Jellyfin only. ↩︎