Repository navigation
PLP 2.1.1 — Stability & Layout Fixes
Pars Local Player 2.1.1 is a maintenance-focused release that improves layout stability, cinema mode behavior, and on-screen playback feedback.
This release primarily targets Linux window manager issues, cinema mode resizing bugs, and overall playback robustness.
Added
Now Playing Overlay
- Added a lightweight “Now Playing” overlay rendered directly on the video surface
- Displays the currently playing title when playback starts or resumes
- Automatically hides after a short delay
- Includes smooth fade-out animation
- Repositions correctly on window resize, fullscreen, and cinema mode
Fixed
Cinema Mode
- Fixed video not expanding to fill available space
- Removed empty layout gaps when entering cinema mode
- Corrected layout restoration when exiting cinema mode
- Preserved dock visibility and sizing across cinema mode toggles
Linux Window & Layout Issues
- Fixed video widget collapsing after restoring window state
- Fixed incorrect layout sizing after
restoreState()on Linux - Forced safe layout refresh without using
adjustSize() - Ensured video widget always re-expands after dock visibility changes
- Improved first-show behavior on Linux window managers
Playback & Rendering
- Fixed cases where video was not repainted after layout changes
- Improved stability when switching playback states
- Ensured correct toolbar and playlist icon state updates
Improved
QtMultimedia / FFmpeg Backend
- Explicitly forces the FFmpeg backend for QtMultimedia
- Platform-specific hardware decoding priorities:
- Windows: D3D11VA, DXVA2, D3D12VA, QSV
- Linux: VAAPI
- macOS: VideoToolbox
- Enabled experimental codec support when available
- Extended protocol whitelist for streams and local media
- Playback failures now report errors instead of failing silently
Metadata Handling
- Media metadata access is now fully defensive
- Missing or unsupported metadata keys no longer cause crashes
- Compatible across different Qt / PyQt6 versions
UI & Behavior
- Improved default window sizing on smaller screens
- Ensured restored windows always remain visible on screen
- Improved resize handling during fullscreen and dock toggling
Technical Notes
- Python 3.10+
- PyQt6
- QtMultimedia (FFmpeg backend)
- No telemetry
- No background services
- Network access only when explicitly opening streams
Known Issues
Platform Limitations
PLP may have bugs on Linux or macOS.
This is due to platform-specific limitations of QtMultimedia, FFmpeg, graphics drivers, and window managers.
Possible limitations include:
- Codec availability depending on system FFmpeg builds
- Hardware decoding availability depending on GPU drivers
- Differences between Wayland and X11 behavior
- Some GPU overlays may not be capturable via screenshots
PLP is designed to:
- Fail safely
- Never crash due to media or metadata issues
- Avoid corrupting state or user data
- Always report errors clearly
Distribution Notes
macOS .app Bundle
The macOS
.appbundle cannot be distributed directly via GitHub Releases.
If you are looking for the macOS build:
- Visit https://parrothat.org/plp/downloading.html?target=macos
- This will download the .app immediately
This ensures:
- Proper application bundle structure
- Correct macOS signing and packaging
- Fewer issues with Gatekeeper and quarantine flags
© 2025 ParrotHat Foundation
Pars Local Player — Predictable, minimal, and reliable.