El Decko MPRIS-Backend

An El Decko backend to control media applications via the MPRIS2 dbus interface.

First run

Upon running El Decko the first time with this backend installed it will create an empty default config to connect to your local OBS Studio instance at: $XDG_CONFIG/eldecko/backend/mpris.json.
Please update the generated default credentials with the actual port and password of what is shown inside your OBS Studio Websocket Settings.

Use this backend

In order to use this backend you need to supply the streamdeck.json generated by El Decko Core with the following key_config:

{
    "STREAM_DECK_SERIAL_NUMBER": {
        "brightness": 30,
        "key_config": {
            "0": {
            "backend": "edb_mpris",
            "event": "PLAY",
            "event_parameters": {"player":"rhythmbox"},
            "image_idle": null,
            "image_pressed": null
            }
        }
    }
}

This will configure the very first key (0) to use this plugin (edb_mpris) and bind the event PLAY to it. If the event_parameters are kept empty "event_parameters": {} the respective event will be send to all available MPRIS2 clients.
If event_parameters contains "player":"<some_mpris_player_name" it will only send the MPRIS event to all players matching player.

Supported MPRIS2 controls

• Play
• Play/Pause
• Next
• Previous

Additional controls

• Mute
• Unmute
• Toggle Mute

Requirements

Python

Python >= 3.8
pympris dbus-python
cmake
dbus-1-devel
glib2-devel
python3**-devel