edde746
2e4ba352f4
The two prior attempts at #783 failed for lack of a reliable trigger: re-setting audio-device to its own value is a no-op, and gating recovery on audio-device-list changes while current-ao is null never fires in the real flows (a paused player only discovers the dead WASAPI session at unpause, when the device list is already stable; a zombie session that consumes samples silently never goes null). Replace the single gate with a recovery scheduler on the mpv event thread, ticked every wait-event timeout: - WM_POWERBROADCAST resume (both PBT variants, via the plugin's existing window-proc delegate) requests unconditional ao-reloads at +1.5s and +6s after wake — the only trigger that reaches zombie sessions; the second shot covers a first reload landing while the audio stack is still restoring. The handoff is a single atomic flag: no mpv calls or timers from the platform thread, so there is nothing to clean up on dispose. - current-ao falling to null arms clock-driven retries (budget 5, x2 backoff capped at 8s); retries must be clock-driven because a failed ao-reload falls back to null without a property change event. A device-list change while null refreshes the budget, and audio-device-list is now observed natively so recovery does not depend on the Dart side. Every trigger, attempt, and outcome logs as [mpv:audio-recovery] at warn level so exported logs from the reporter are actionable if this still misses. Verified with synthetic PBT_APMRESUMEAUTOMATIC while playing and while paused: full WASAPI reinit both times, audio restarts on unpause. Ref #783
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