#mpd #discord #rpc #music #mopidy

app mpd-discord-rpc

Displays your currently playing song / album / artist from MPD in Discord using Rich Presence

17 stable releases

Uses new Rust 2021

1.5.2 Jun 21, 2022
1.4.1 Feb 26, 2022
1.2.2 Jun 6, 2021
1.2.0 Oct 14, 2020
1.1.2 Mar 21, 2020

#12 in Audio

Download history 46/week @ 2022-03-14 45/week @ 2022-03-21 2/week @ 2022-03-28 7/week @ 2022-04-04 1/week @ 2022-04-11 3/week @ 2022-04-18 86/week @ 2022-04-25 92/week @ 2022-05-02 17/week @ 2022-05-09 242/week @ 2022-05-16 91/week @ 2022-05-23 100/week @ 2022-05-30 47/week @ 2022-06-06 87/week @ 2022-06-13 35/week @ 2022-06-20 7/week @ 2022-06-27

204 downloads per month

MIT license

23KB
415 lines

MPD Discord RPC

crates.io aur

Displays your currently playing song / album / artist from MPD in Discord using Rich Presence, along with the album art.

It includes support for multiple MPD hosts if, like me, you have more than one server you alternate between.

The program does not require MPD or Discord to be running in order to run.

Once installed just run mpd-discord-rpc.

status image

Installation

Cargo

The cargo package can be found here.

cargo install mpd-discord-rpc

Arch Linux

The AUR package can be found here.

yay -S mpd-discord-rpc-git

NixOS

You can use the mpd-discord-rpc package in nixpkgs. Users of home-manager can also use the services.mpd-discord-rpc.enable option.

Many thanks to Ilan Joselevich for maintaining both of those.

Configuration

Running the program once will generate a default configuration file. On Linux this will be at ~/.config/discord-rpc/config.toml

  • id - The Discord application ID to run through.
  • hosts - An array of MPD server host socket addresses. Each one will be tried in order until a playing server is found.
  • format - Format strings. Tokens are listed below.
    • details - A format string for the top line. This is the song title by default.
    • state - A format string for the second line. This is the artist / album by default.
    • timestamp - The timestamp mode for the third line. This is 'elapsed' by default. Can be one of elapsed, left or off. Falls back to elapsed.
    • large_image - The name of the rich presence asset that gets displayed as the large image. This is "notes" by default. Setting this to "" disables the large image.
    • small_image - The name of the rich presence asset that gets displayed as the small image. This is "notes" by default. Setting this to "" disables the small image.
    • large_text - A format string that is displayed upon hovering the large image. Setting this to "" disables the hover.
    • small_text - A format string that is displayed upon hovering the small image. Setting this to "" disables the hover.

Formatting Tokens

Any part of the format string that does not match one of these tokens will be displayed as is. The following will automatically be replaced with their value from MPD:

  • $title
  • $album
  • $artist
  • $date
  • $track
  • $disc
  • $genre
  • $duration
  • $elapsed

Default Configuration

This configuration file is automatically generated if one does not exist. It is included here for reference.

id = 677226551607033903
hosts = ["localhost:6600"]

[format]
details = "$title"
state = "$artist / $album"
timestamp = "elapsed"
large_image = "notes"
small_image = "notes"
large_text = ""
small_text = ""

Dependencies

~11–20MB
~407K SLoC