mpris-scrobbler - Man Page

The MPRIS scrobbler user daemon

Synopsis

mpris-scrobbler [Options.​.​.​]

Description

mpris-scrobbler is a minimalistic user daemon for submitting the current playing songs to   any of the supported scrobbling services.​

It can interact with any media-player that conforms to the MPRIS D-Bus Interface Specification[1].​

Services

mpris-scrobbler supported services are:

listenbrainz.​org

Music service associated with the Music Brainz audio fingerprinting service.​

libre.​fm

Open source variant of the original audioscrobbler.​com service.​

last.​fm

The evolution of the closed audioscrobbler.​com service under the CBS umbrella.​

Options

-h,  --help

Print a short help message and version number and exit.​

-q,  --quiet

Do not print any debugging messages.​

-v,  -vv,  -vvv, --verbose=[1.​.​3]

Increase print verbosity to level:

1 Info messages.​

2 Debug messages.​

3 Tracing messages.​

The default is to display only error and warning messages.​

Signals

SIGTERM

Upon receiving this signal the mpris-scrobbler daemon will try to cleanly exit.​

SIGINT

The mpris-scrobbler daemon treats this signal the same as SIGTERM.​

SIGHUP

Reloads the credentials file[3], then reloads the current playing track if possible and submits it to the loaded services.​

Environment

$XDG_CONFIG_HOME,  $XDG_DATA_HOME,  $XDG_CACHE_HOME,  $XDG_RUNTIME_DIR

The mpris-scrobbler daemon uses these variables in accordance to the   XDG Base Directory specification[2] to find its configuration and save its PID file.​

Notes

1.​  MPRIS D-Bus Interface Specification

https://specifications.​freedesktop.​org/mpris-spec/latest/

2.​  XDG Base Directory specification

http://standards.​freedesktop.​org/basedir-spec/basedir-spec-latest.​html

3.​  mpris-scrobbler-credentials(5)

See Also

mpris-scrobbler-signon(1), mpris-scrobbler-credentials(5)

Info

2026-09-25