MprisCustomHud
by technicfan
MprisCustomHud shows the music playing on Linux through MPRIS in CustomHud and Hudder overlays, reading variables from each active media player.
What it does
The mod exposes MPRIS media information as variables for the CustomHud and Hudder overlays, so an overlay can display the title, artist and album of what is playing. Values come from the Mpris DBus specification, and the mod is intended for Linux only. String variables are left blank when no value is available, and list variables name the players found, with the first four letters of each variable name taken from the MPRIS default prefix. Album art is provided as a variable with the MPRIS prefix removed.
Player selection is handled by commands. By default the mod follows the active player, the cycle command moves between active players, and a preferred player can be chosen so that it is always the one shown. The onlyPreferred setting limits the overlay to that preferred player, and the refresh command reloads the variables. The mod requires Fabric API and works with Hudder, and it is published for Fabric across 20 release versions, 1.20.4 – 26.3, as a client-side mod under the MIT License, with snapshot builds available.
Key features
Playing music in overlays
Variables for the current track are passed to CustomHud and Hudder, which can then render them on screen.
Active player cycling
A cycle command moves the displayed source between the media players that are currently active.
Preferred player
A chosen player can be set as preferred so it stays the one shown when several players run.
Only preferred mode
The onlyPreferred setting hides every other player, so the overlay shows only the preferred source.
Variable refresh
A refresh command reloads the MPRIS variables without restarting the game.
Compatibility
Latest build for each game version and loader.
26.x5 of 5 versions with builds
1.21.x12 of 12 versions with builds
1.20.x3 of 3 versions with builds
This mod also publishes snapshot builds. Snapshots are not shown in the matrix.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Optional 1
Use cases
Who it’s for: Players on Linux who want their current music shown in a CustomHud or Hudder layout, and who use Fabric.
How it compares
MinecraftMPRIS is a Fabric client-side mod for 1.20.1 – 1.21.11, released under the GNU Lesser General Public License v3.0 or later, and it is open source. MCPRIS is a Fabric client-side mod for 1.21.1 only, released under CC0 1.0 Universal, and it is open source. Custom pvp hud is a Fabric client-side mod for 1.21.11 – 26.1.2 under the MIT License, and it is not open source.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| MprisCustomHud | Fabric | 1.20.4 – 26.3 | Client-side only | 2026-09-15 |
| MinecraftMPRIS | Fabric | 1.20.1 – 1.21.11 | Client-side only | 2026-01-19 |
| MCPRIS | Fabric | 1.21.1 | Client-side only | 2026-05-26 |
| Custom pvp hud | Fabric | 1.21.11 – 26.1.2 | Client-side only | 2026-09-13 |
Questions
Does MprisCustomHud need Fabric API?
Does the mod work outside Linux?
Which Hudder versions does it work with?
In the catalog
MprisCustomHud is one of 36,990 Utility mods on ModsFinder, and one of 25,772 Utility mods for Fabric. 8,071 mods support Minecraft 26.3.
More from technicfan
Similar mods
What the author says
Variables for CustomHud and Hudder to show currently playing music using the Mpris DBus Spec. Available for all versions CustomHud v4 is available for!
Official listing
- Modrinth page
- modrinth.com/mod/mpriscustomhud
- Owner
- technicfan
- Published
- 2025-11-16
- Updated on Modrinth
- 2026-09-15
- Facts verified
- 2026-10-15