
Modrinth · Minecraft mod
MprisCustomHud
(Linux only) Mpris music info addon for CustomHud and Hudder
Quick answer
Which MprisCustomHud release matches 26.1.2?
MprisCustomHud 1.3.6 targets 26.1, 26.1.1, 26.1.2 with Fabric. It must be installed on the client. Do not install it on the dedicated server. All 1 required mods have matching files.
Where it goes
Is MprisCustomHud required on the client, server, or both?
It must be installed on the client. Do not install it on the dedicated server.
This file is marked client-only.
What else does MprisCustomHud 1.3.6 need?
1.3.6 on 26.1.2. Every mod below is checked against that same setup.
Install Fabric API first. We found matching files for this game-version and loader setup.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add MprisCustomHud without breaking your instance.
Built for MprisCustomHud 1.3.6 on 26.1.2. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 1.3.6. It targets 26.1, 26.1.1, 26.1.2 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Fabric API first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
It must be installed on the client. Do not install it on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside 1.3.6. It opens that exact file at the source.
About this project
What does MprisCustomHud add?
MprisCustomHud
Important
Description
Variables for CustomHud and Hudder to show currently playing music using the Mpris DBus Spec.
Available for all versions CustomHud v4 is available for!
Works with Hudder 8.x, 9.x on version 1.21.9/10 and 10.x for version 1.21.11/26.1.x
It is heavily inspired by Hudify, so thank you for your work Lightningtow ig :)
Note
- Not all variables have to be/will be populated by the player/music application
General Variables
| Name | Type | Description |
|---|---|---|
mpris_busname |
String | busname |
mpris_track |
String | track name |
mpris_trackid |
String | the unique mpris track id (mostly for debugging) |
mpris_album |
String | name of the album the track is from |
mpris_repeat |
String | repeat status - "None", "Track" or "Playlist" |
mpris_artist |
String | name of the first artist coming from mpris |
mpris_name |
String | the pretty player name from the Identity attribute of org.mpris.MediaPlayer2 |
mpris_lyrics |
String | xesam:asText |
mpris_created_at |
String | xesam:contentCreated |
mpris_first_played |
String | xesam:firstUsed |
mpris_last_played |
String | xesam:lastUsed |
mpris_art_url |
String | xesam:artUrl |
mpris_url |
String | xesam:url |
mpris_shuffle |
Boolean | wether shuffle is on |
mpris_playing |
Boolean | wether the song is playing or paused/stopped |
mpris_exists |
Boolean | wether the current track is real or a placeholder |
mpris_has_album_art |
Boolean | wether the track has an album art/it is loaded |
mpris_data_age |
Number | the age of the metadata information (track, trackid, album, artist, artists, duration, ...) in milliseconds |
mpris_progress |
Number | progress in milliseconds |
mpris_duration |
Number | duration of the track in milliseconds |
mpris_rate |
Number | the rate/speed the music is playing as floating point number |
mpris_volume |
Number | the volume the music is playing at as a floating point number (usually between 0 and 1) |
mpris_bpm |
Number | xesam:audioBPM |
mpris_disc |
Number | xesam:discNumber |
mpris_number |
Number | xesam:trackNumber |
mpris_times_played |
Number | xesam:useCount |
mpris_auto_rating |
Number | xesam:autoRating |
mpris_user_rating |
Number | xesam:userRating |
mpris_album_width |
Number | the absolute pixel width of the album art |
mpris_album_height |
Number | the absolute pixel height of the album art |
mpris_album_color |
Number | the rgb value of the dominant color of the album art |
mpris_artists |
List of String | list of artists for the current player |
mpris_album_artists |
List of String | xesam:albumArtist for the current player |
mpris_comments |
List of String | xesam:comment for the current player |
mpris_composers |
List of String | xesam:composer for the current player |
mpris_genres |
List of String | xesam:genre for the current player |
mpris_lyricists |
List of String | xesam:lyricist for the current player |
CustomHud specific things
- From what I can tell, it is not easily possible to have a list as a field/attribte so here are only the lists for the current player
- All String variables are either not empty or
null - Lists have the the first four letters of the variable name after
mpris_as the default prefix (for iteration) - PlayerInfo objects have all general variables +
mpris_album_artwith thempris_prefix removed as fields
| Name | Type/Usage | Description |
|---|---|---|
mpris_player |
{mpris_player:<field>} or {mpris_player:<player>:<field>} |
exposes the fields of a PlayerInfo Object; player can be the full busname or only the last part |
mpris_players |
List of PlayerInfo like Objects | just a list of currently active PlayerInfo Objects (same <fields> as above) |
mpris_album_art |
Icon | draws the album art image of the current player to the screen |
See https://www.freedesktop.org/wiki/Specifications/mpris-spec/metadata for details on the xesam:<name> and mpris:<name> variables.
Hudder specific things
Variables
| Name | Type | Description |
|---|---|---|
has_mpris |
Boolean | always true |
mpris_player |
Object/PlayerInfo | the PlayerInfo object of the currently selected player or null |
mpris_players |
List<PlayerInfo> | a list of currently tracked players |
Functions/Methods
| Name | Arguments | Effect |
|---|---|---|
mpris_player |
String name |
returns the PlayerInfo object with the bus name org.mpris.MediaPlayer2.<name> or null |
mpris_album_art |
String name or AlbumArt albumArt, int x, int y, int width, int height |
draws the album art image; if the track has no album art, it draws a fallback; if width or height is 0 it will retain the original aspect ratio; if both are 0, it will use the pixel dimensions (way too big lol) |
Objects
PlayerInfo:
String busname- the busnameString name- player nameString repeat- repeat status - seempris_repeatboolean shuffle- shuffle statusboolean playing- wether music is playingdouble rate- the rate the music is playing atdouble volume- the volume the music is playing at (usually between 0 and 1)Metadata metadata- metadatalong progress()- returns the current progress (in ms)
Metadata:
String track- current track -xesam:titleString trackid- current track id -mpris:trackidString album- current album -xesam:albumString artist- first artistString art_url-mpris:artUrlString lyrics-xesam:asTextString created_at-xesam:contentCreatedString first_played-xesam:firstUsedString last_played-xesam:lastUsedString url-xesam:urlList<String> artists- all artists -xesam:artistList<String> album_artists-xesam:albumArtistList<String> comments-xesam:commentList<String> composers-xesam:composerList<String> genres-xesam:genreList<String> lyricists-xesam:lyricistint bpm-xesam:audioBPMint disc-xesam:discNumberint number-xesam:trackNumberint times_played-xesam:useCountfloat auto_rating-xesam:autoRatingfloat user_rating-xesam:userRatinglong duration- duration of current track (in ms)AlbumArt album_art- information on the album artlong data_age()- returns the age of the object (in ms)
AlbumArt:
int width- width in pixelsint height- height in pixelsint color- the rgb value of the dominant color of the album artboolean exists()- wether the object for the real image or the fallback one
Controls
There are keybindings for play/pause, next, previous, refresh and cycle through active players that all have correcsponding commands.
Configuration
By default a player is selected from the active ones. To cycle through the currently active ones, use the mpriscustomhud cycle command (only works onlyPreferred is disabled (default)).
You can choose a player to prefer over others by using mpriscustomhud preferred <player> so that one will always be shown if it's active.
If you don't want to see other players (only the preferred one), you can use mpriscustomhud onlyPreferred true. This will result in no player being selected if you didn't set a preferred one.
With mpriscustomhud player, you get the currently active player, with mpriscustomhud onlyPreferred and mpriscustomhud preferred the values for that and with mpriscustomhud refresh, you can refresh the variables.
Flatpak notice
- when you're running Minecraft in a Flatpak sandbox, you have to add
org.mpris.MediaPlayer2.*to the list of well known session bus names your launcher can talk to e.g. with Flatseal
Problems/Todo
currently there is no album art variable; maybe I will try to add it at some pointdone
Libraries used
- dbus-java
- Improved version of java DBus library provided by freedesktop.org https://dbus.freedesktop.org/doc/dbus-java
License
This Mod is licensed under the MIT License
Project description from Modrinth.
Pick your setup
MprisCustomHud by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.3
1 loader build26.2-snapshot-3
1 loader build26.2
1 loader build26.1.2
1 loader build26.1.1
1 loader build26.1
1 loader build1.21.11
1 loader build1.21.10
1 loader build1.21.9
1 loader build1.21.8
1 loader build1.21.7
1 loader build1.21.6
1 loader buildShowing the newest 12 of 21 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
MprisCustomHud versions and loaders
1.3.6
mpriscustomhud-1.3.6.jar
27 Aug 2026
1.3.5
mpriscustomhud-1.3.5.jar
16 Jun 2026
1.3.4
mpriscustomhud-1.3.4.jar
25 Apr 2026
1.3.3
mpriscustomhud-1.3.3.jar
23 Apr 2026
1.3.2
mpriscustomhud-1.3.2.jar
17 Apr 2026
1.3.0
mpriscustomhud-1.3.0.jar
11 Apr 2026
Looking for an older file? The official Modrinth project page is in Resources.