Playing | Paused | |
---|---|---|
No icon | ![]() |
![]() |
Show icon | ![]() |
![]() |
No cover | ![]() |
![]() |
A Discord Rich Presence client for MPRIS-compatible media players with album/song cover art support
You can install mprisence from AUR
paru -S mprisence # or any other AUR helpers
You can install mprisence from the source by
curl -s https://raw.githubusercontent.com/lazykern/mprisence/main/scripts/install.sh | bash -s
cargo install --git "https://github.com/lazykern/mprisence.git"
To start mprisence, simply run this command:
mprisence
See also:
The rich presence can be configured to the user's preference by providing the configuration file at ~/.config/mprisence/config.toml
or $XDG_CONFIG_HOME/mprisence/config.toml
.
See Example config file for more details on configuration.
To download the example config file:
curl -s https://raw.githubusercontent.com/lazykern/mprisence/main/scripts/example-config.sh | bash -s
See also:
The cover art will be fetched from MusicBrainz API. Note that the result is not guaranteed to always be available nor correct. To reduce the chance of missing cover art:
Will upload the cover art from player metadata or audio tag to ImgBB and use the uploaded image as the cover art.
The user must set the ImageBB API key in the configuration file by providing the key as below.
And make sure to add provider = ["imgbb"]
to [cover.provider]
in the config file.
[cover.provider.imgbb]
api_key = "<YOUR API KEY>"
The application must be restarted after the configuration file is updated
For most Linux distributions, you can use systemd to autostart mprisence.
systemctl --user enable --now mprisence.service
curl -s https://raw.githubusercontent.com/lazykern/mprisence/main/scripts/autostart.sh | bash -s
sudo ln -s $(which mprisence) /usr/local/bin/mprisence
mkdir -p "$HOME/.config/systemd/user"
curl https://raw.githubusercontent.com/lazykern/mprisence/main/systemd/mprisence-local.service >"$HOME/.config/systemd/user/mprisence.service"
systemctl --user daemon-reload
systemctl --user enable --now mprisence.service
If the configuration file is updated, you must restart the service
systemctl --user restart mprisence.service