edde746 a9f0532f5f fix(ui): keep pushed screens clear of the Android navigation bar
Plezy is edge-to-edge on Android whether it asks to be or not: targetSdk is
36, Android 15 enforces edge-to-edge for apps targeting 35+, and Android 16
disables the windowOptOutEdgeToEdgeEnforcement escape hatch. The only
SystemUiMode.edgeToEdge call in the app fires on video-player exit, so on
API 35+ the window is edge-to-edge from the first frame and
MediaQuery.padding.bottom is a real ~48dp overlap under 3-button navigation.

MainScreen's phone layout hides that. It supplies a bottomNavigationBar and
never sets extendBody, so Flutter's Scaffold strips padding.bottom from the
body MediaQuery and every tab is already safe. Routes pushed on the profile
navigator are full-screen siblings of MainScreen with no bottom bar, so they
receive the untouched inset and nothing consumes it - the last settings card
and the final log lines render under the back, home, and recents buttons.

Three shared hosts own most of those routes, so the inset is consumed there:
FocusedScrollScaffold (25 screens, counting the SettingsPage wrapper) and
FocusableDetailScreenMixin.buildDetailScaffold (4) now append a trailing
SliverSystemBottomInset, and the four screens that build their own Scaffold
around a CustomScrollView append it directly.

The new widget codifies the convention this repository had already written
down but open-coded - insets baked into the scroll content rather than a
SafeArea around the scroll view - so content still paints under the bar while
the scroll extent grows enough to bring the last row above it. It reads
padding from its own context and collapses to zero height wherever the inset
is already zero: desktop, Android TV, tvOS via _AppleTvScale, and inside
MainScreen's tab bodies. No platform branching, and it stacks additively with
the music detail screens' existing mini-player spacers, which is correct
because the mini-player itself floats above the navigation bar on a pushed
route.

Scroll views that are not sliver lists take the inset in their own padding:
the companion remote's ListView, the auth screen's scroll container, and the
two SliverFillRemaining sign-in forms, whose children size themselves from
the extent remaining before them and so cannot be helped by a trailing
sliver. The logs empty state is left alone for the same reason inverted - it
already fills the viewport, and a trailing inset would only add scroll slack.

Verified on a Pixel 7 running Android 16 (API 36) with 3-button navigation:
Settings, Logs, and Video Playback all end clear of the bar.

close #1766
2026-08-03 00:05:21 +02:00
2026-07-30 01:44:55 +00:00
2025-10-22 12:45:29 +02:00
2026-05-18 22:52:51 +02:00
2025-10-22 12:45:29 +02:00
2025-10-22 12:45:29 +02:00

Plezy Logo 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

Plezy mobile screenshots

Download

Download on the App Store Get it on Google Play Available at the Amazon App Store Get it from Microsoft

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
    
  • AUR (Arch Linux) - Community maintained by @jianglai:
    yay -S plezy-bin
    
  • 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 and Jellyfin 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 and Jellyfin side by side
  • Profiles with per-profile downloads, watch state, and settings; Plex Home switching with PIN
  • Jellyfin local-server discovery, multiple URLs per server, and Quick Connect sign-in
  • 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.44.0+
  • 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

End-to-end tests (Android emulator plus a Dockerized Jellyfin fixture):

python3 scripts/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


  1. Jellyfin only. ↩︎

  2. Plex only. ↩︎

  3. Requires connecting the service under Settings > Services. ↩︎

  4. In-app HDR toggle on Windows, macOS, iOS, and tvOS. Dolby Vision on Android and Apple TV. ↩︎

  5. Desktop, Android TV, and Apple TV. ↩︎

  6. Requires the mpv player backend — unavailable on iOS and tvOS, and Android defaults to ExoPlayer. ↩︎

  7. Android, iOS, and macOS — not on Android TV or Apple TV. ↩︎

  8. Windows, Android, and tvOS. ↩︎

  9. Progress sync on Android. ↩︎

  10. Where your server provides lyrics. ↩︎

  11. tvOS pauses music when the app is backgrounded. ↩︎

  12. Not available on tvOS. ↩︎

  13. Desktop only. ↩︎

  14. Real-time scrobbling on Trakt and Simkl; MyAnimeList and AniList update on completion. ↩︎

  15. Android TV / Fire TV and tvOS. ↩︎

S
Description
Modern cross-platform Plex & Jellyfin client built with Flutter
Readme GPL-3.0
223 MiB
Languages
Dart 73.8%
GLSL 13.3%
Kotlin 4.3%
C++ 2.3%
Python 1.7%
Other 4.3%