MPRIS MiniPlayer

MPRIS MiniPlayer is a small GTK4/libadwaita mini player for Linux media players that expose the MPRIS interface on the session D-Bus.

Visit the project homepage for an overview and downloads.

It is not tied to a specific player. It is intended to work with Sidra, Slipmat, Cider, VLC, Spotify, Strawberry, Rhythmbox, Elisa, browsers exposing media sessions, Mopidy, spotifyd, mpv with an MPRIS plugin, and similar clients.

Screenshot

Install

Download the latest release asset from the GitHub releases page.

For Flatpak, install the bundle with:

flatpak install --user ./MPRIS-MiniPlayer-<version>-x86_64.flatpak

For Debian or Ubuntu on amd64, install the Debian package with:

sudo apt install ./mpris-miniplayer_<version>_amd64.deb

deb-get is a tool that makes it easy to install Debian packages from the command line.

After installing deb-get, you can install MPRIS MiniPlayer with:

sudo deb-get install mpris-miniplayer

For Fedora on x86_64, install the RPM package with:

sudo dnf install ./mpris-miniplayer-<version>.x86_64.rpm

Run it from your application launcher, or from a terminal.

For Flatpak:

flatpak run io.github.ChrisLauinger.MprisMiniPlayer

For the Debian package:

mpris-miniplayer

MPRIS MiniPlayer needs at least one running MPRIS-compatible media player to show playback controls. When it starts without a player, it can stay hidden in the background and show the window automatically later.

Features

• Detects MPRIS players on the session bus
• Selects a player automatically, preferring one that is playing or paused
• Shows track title, artist, album, and album art, with a fallback player icon when artwork is unavailable
• Provides previous, play/pause, and next controls
• Supports synchronized shuffle and repeat modes when exposed by the player
• Shows an adaptive, scrollable queue for players with MPRIS TrackList support
• Shows playback progress and time
• Lets you seek when the selected player supports it
• Lets you adjust volume when the selected player exposes MPRIS volume control
• Lets you choose between available players
• Provides a compact mode for a smaller window layout
• Updates the UI when player metadata changes
• Can keep running in the background when no player is available
• Can show and hide the window automatically as players appear or disappear
• Can show a status indicator with current track information, media controls, and volume presets when the desktop supports it
• Adjusts volume by scrolling over the status indicator, with temporary icon feedback and a 100% upper limit
• Provides status indicator actions for showing or hiding the window, compact mode, preferences, about, and quit
• Can tint the player with a color from the current album cover
• Provides preferences for compact mode, album color tint, keeping the queue open, background notifications, automatic visibility, status indicators, and start on login
• Shows a link in the main menu and status indicator when a newer stable release is available
• Hides the window on close; use Quit to stop the app

Build from Source

Install the typical development dependencies on Debian or Ubuntu:

sudo apt install meson ninja-build valac libgtk-4-dev libadwaita-1-dev libsoup-3.0-dev gettext desktop-file-utils appstream

Build and run:

meson setup build
meson compile -C build
meson devenv -C build ./src/mpris-miniplayer

meson devenv runs the build-tree binary with the generated GSettings schemas available, so preferences work before installing the app.

Install locally:

sudo meson install -C build

Uninstall the local build:

sudo ninja -C build uninstall

Project Website

The static website lives in docs/. To publish it at https://chrislauinger77.github.io/mpris-miniplayer/, open this repository's Settings → Pages, choose Deploy from a branch, select main and /docs, then save. GitHub Pages will publish subsequent changes to docs/ when they are pushed to main.

Preview it locally with python3 -m http.server 8000 --directory docs and open http://localhost:8000/. If the application icon or screenshot changes, copy the updated files from data/ into docs/assets/.

Maintainer Release

Releases use one manually started workflow with two stages, so the published files are exactly the ones that were tested. The release environment must have the maintainer configured as a required reviewer and allow deployments from main. Leave Prevent self-review disabled if the same maintainer starts and approves the run.

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗