Sign inSign up

giof71/mpd-scrobbler

By giof71

Updated about 19 hours ago

Scrobbler for mpd (Last.fm, Libre.fm and Jamendo)

Image
1

10K+

giof71/mpd-scrobbler repository overview

mpd-scrobbler-docker

A Docker image for mpdscribble (Last.fm, Libre.fm and Jamendo scrobbler for mpd).

Reference

First and foremost, the reference to the awesome projects:

Music Player Daemon
MPDScribble

Source: GitHub
Images: DockerHub

Why

I prepared this Dockerfile Because I wanted to be able to install mpdscribble easily on any machine (provided the architecture is amd64 or arm). Configuring the container is easy through a webapp like Portainer.

Prerequisites

You need to have Docker up and running on a Linux machine, and the current user must be allowed to run containers (this usually means that the current user belongs to the "docker" group).

You can verify whether your user belongs to the "docker" group with the following command:

getent group | grep docker

This command will output one line if the current user does belong to the "docker" group, otherwise there will be no output.

The Dockerfile and the included scripts have been tested on the following distros:

  • Manjaro Linux with Gnome (amd64)
  • Asus Tinkerboard
  • Raspberry Pi 3 and 4, both 32 and 64 bit

As I test the Dockerfile on more platforms, I will update this list.

Get the image

Here is the repository on DockerHub.

Getting the image from DockerHub is as simple as typing:

docker pull giof71/mpd-scrobbler

You may want to pull the "stable" image as opposed to the "latest".

Usage

You can start mpd-scrobbler by simply typing:

    docker run -d --rm \
        -e LASTFM_USERNAME=lastfmuser \
        -e LASTFM_PASSWORD=lastfmpassw \
        -e MPD_HOSTNAME=mpd-hostname \
        -e MPD_PORT=6600 \
        giof71/mpd-scrobbler
Environment Variables

The following tables reports all the currently supported environment variables.

VARIABLENOTES
USER_MODEEnables user mode if set to YES
PUIDRun using this User id. Defaults to 1000.
PGIDRun using this Group id. Defaults to 1000.
MPD_HOSTThe host running MPD, possibly protected by a password([PASSWORD@]HOSTNAME). Defaults to localhost. Leave blank or localhost when running in network=host mode.
MPD_PORTThe port that the MPD listens on and mpdscribble should try to connect to. Defaults to 6600, the default MPD port.
SCRIBBLE_VERBOSEHow verbose mpdscribble's logging should be. Defaults to 1.
LASTFM_USERNAMEUsername for Last.fm
LASTFM_PASSWORDPassword for Last.fm
LIBREFM_USERNAMEUsername for Libre.fm
LIBREFM_PASSWORDPassword for Libre.fm
JAMENDO_USERNAMEUsername for Jamendo
JAMENDO_PASSWORDPassword for Jamendo
PROXY
STARTUP_DELAY_SECDelay before starting the application, defaults to 0
Volumes
VolumeDescription
/app/scribble/logWhere mpdscribble will write its journals and its log file

Notable changes to the configuration

Changes to Environment Variables

A few environment variables have been deprecated, see the following table.

Deprecated VariableDeprecated SinceComment
USE_MPD_PASSWORD2022-10-21Removed variable: the MPD password must be specified with MPD_HOSTNAME if needed
USE_MPD_PASSWORD2021-11-27This variable is not required anymore: just set the MPD_PASSWORD variable
Changes to volumes
DateDescription
2023-03-03The log volume is now /app/scribble/log instead of app/scribble

Build

You can build (or rebuild) the image by opening a terminal from the root of the repository and issuing the following command:

docker build . -t giof71/mpd-scrobbler

It will take very little time even on a Raspberry Pi. When it's finished, you can run the container following the previous instructions.
Just be careful to use the tag you have just built.

Change History

Change DateMajor Changes
2022-10-24Support for daily builds
2022-10-24Bugfix (wrong variable references and missing permissions)
2022-10-21Run with unprivileged user
2022-10-21Switch to mpdscribble

Tag summary

Content type

Image

Digest

sha256:227eebb15

Size

6.5 MB

Last updated

over 3 years ago

docker pull giof71/mpd-scrobbler