Skip to content
This repository has been archived by the owner on Aug 27, 2024. It is now read-only.

A Backend for El Decko to emulate media key press from your Stream Deck

License

Notifications You must be signed in to change notification settings

Z-Ray-Entertainment/el_decko_backend_mpris

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

❗ Discontinued there is now: StreamController

El Decko MPRIS-Backend

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

build result

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