MPDRIS2(1)

📦 version 0.9.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 MPDRIS2 — the manual, but make it make sense 💖

okay bestie, so this is the mpDris2 man page, section 1, and it's genuinely iconic. it lives in the D-Bus services corner of the manual world. let's get into it 🫶

✨ NAME ✨

mpDris2 — the media player interface (MPRIS2) bridge for MPD 💅

🎀 SYNOPSIS 🎀

that's it. that's the whole vibe. options only, no drama.

🌸 DESCRIPTION 🌸

so mpDris2 is an implementation of the MPRIS2 media player interface, but as a client for MPD. which means — and this is the slay part — MPRIS2 clients can control MPD and watch its track changes through a standard D-Bus interface. it's giving translator, it's giving middle girlie, it's giving bridge. 🌉

it can also respond to multimedia keys if it's running under GNOME, and it'll send track-change notifications if python-notify is installed. not me being multi-talented 😭✨

normally you don't even run it by hand — it gets run automatically via D-Bus service activation. and on systems that follow the freedesktop.org Desktop Application Autostart Specification</>, it'll be run automatically on login. main character energy, but like, the responsible kind. 👑

🦋 CONFIGURATION 🦋

so mpDris2 is normally configured through this file:

which, typically, is:

what goes inside that file is documented over in:

and here's the hierarchy bestie, listen up: settings in this config file can be overridden by command-line options and environment variables. so the config file is like the base layer, and the other two can just. barge in. respectfully. 💁

💅 OPTIONS 💅

  • -p PATH, --path=PATH — sets the location of the directory that mpd reads music from, and yes it overrides the config file. the default? it uses the path from the config file, or else it tries some likely directories: XDG_MUSIC_DIR from the environment, or XDG_CONFIG_DIRS/user-dirs.dirs, or ~/Music, or ~/music. she's guessing but she's guessing strategically 🍓
  • -h, --help — shows a help message. classic. iconic. always there for you 🫶
  • -d, --debug — emits debug logging messages. turn this on when you want the tea ☕👀

🌈 ENVIRONMENT 🌈

  • XDG_CONFIG_HOME=DIRECTORY, XDG_CONFIG_DIRS=SEARCHPATH — used to find the configuration file XDG_CONFIG_DIRS/mpDris2/mpDris2.conf, following the XDG Base Directory Specification. yeah. spec-compliant. we love a girlie who follows the rules 📋✨
  • MPD_HOST=HOSTNAME — sets the hostname of the mpd server, overriding the configuration file. 👑
  • MPD_PORT=PORT — sets the port number of the mpd server, overriding the configuration file. 🔌
  • XDG_MUSIC_DIR=DIRECTORY — used to find the default music directory, but only if it's not specified in the configuration file or as a command-line option. backup plan energy, we stan 🎧

🔥 SEE ALSO 🔥

lowkey important reminder: the config file is the base, but command-line options and environment variables override it. don't come for me when your MPD_HOST wins over your conf file — that's the whole point bestie 💖

and that's the whole page!! ngl she's short but she's efficient. this was written up in September 2012, and it comes to you from the D-Bus services part of the manual — so go forth, bridge those players, and stay slay ✨🎀💜

📦 where this page comes from