mpd-rich-presence's Introduction

MPD Discord Rich Presence

Gets your current track from MPD, and shows it in your Discord Rich Presence.

It also gets metadata for the song via Last.fm's API, such as the album cover. People clicking on your profile can easily view your current track on last.fm.

Installation

Linux

AUR

A package is also available in the AUR:

yay -S mpd-rich-presence-bin

# if you want to run it as a service:
systemctl --user enable mpd-rich-presence.service
systemctl --user start mpd-rich-presence.service

Binary from GitHub releases

Download the binary from the latest release, and execute it.

Install from source via go

If you have go installed and want to build it from source easily:

go install github.com/nekowinston/mpd-rich-presence@latest

macOS

A Homebrew tap is available:

nekowinston/tap/mpd-rich-presence

Then start & enable the service:

brew services start nekowinston/tap/mpd-rich-presence

Remember to restart this service after updates.

Usage

Configuration is available, but not required. The config file can either be located in $XDG_CONFIG_HOME, ~/.config, or next to the binary.

Example mpd-rich-presence.yml, showing the defaults:

# MPD connection
host: "127.0.0.1"
port: 6600

# can be "mpd" or "lastfm"
branding: mpd

rich_presence:
  appid: "1037215044141854721" # default Discord app id
  # available keys are:
  # %album%
  # %artist%
  # %genre%
  # %title%
  # %year%
  # %mpdver%
  image:
    large: "%album% (%year%)"
    small: "%title%"
  upper: "%title%"
  lower: "by %artist%"
  button: "View on Last.fm"
  # can be "remaining" or "elapsed"
  time: "elapsed"

sleep:
  long: 30s
  short: 5s

# you can turn lastfm off, so no queries will be sent to LastFM.
# Album Art will be empty, it will just show the Logo chosen in "branding"
lastfm:
  enabled: true
  # here you can choose your own api credentials, if you want to
  #apiKey: ""
  #apiSecret: ""