{"id":22320198,"url":"https://github.com/giof71/mpd-scrobbler-docker","last_synced_at":"2025-07-29T13:32:07.187Z","repository":{"id":61774832,"uuid":"424640378","full_name":"GioF71/mpd-scrobbler-docker","owner":"GioF71","description":"Docker Scrobbler for mpd (Last.fm, Libre.fm and Jamendo) based on MPDScribble","archived":false,"fork":false,"pushed_at":"2024-05-06T01:26:06.000Z","size":47,"stargazers_count":5,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-05-06T13:04:04.046Z","etag":null,"topics":["jamendo","lastfm","librefm","mpd","mpdscribble","music-player-daemon","scrobbler","scrobbling"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GioF71.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-11-04T15:13:06.000Z","updated_at":"2023-12-30T17:49:23.000Z","dependencies_parsed_at":"2024-04-17T02:44:33.872Z","dependency_job_id":"d9877df0-3be4-4e68-b696-b3abff5f8bd7","html_url":"https://github.com/GioF71/mpd-scrobbler-docker","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GioF71%2Fmpd-scrobbler-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GioF71%2Fmpd-scrobbler-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GioF71%2Fmpd-scrobbler-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GioF71%2Fmpd-scrobbler-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GioF71","download_url":"https://codeload.github.com/GioF71/mpd-scrobbler-docker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228017867,"owners_count":17856842,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["jamendo","lastfm","librefm","mpd","mpdscribble","music-player-daemon","scrobbler","scrobbling"],"created_at":"2024-12-04T00:12:46.226Z","updated_at":"2024-12-04T00:12:46.689Z","avatar_url":"https://github.com/GioF71.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mpd-scrobbler-docker\n\nA Docker image for mpdscribble (`Last.fm`, `Libre.fm` and `Jamendo` scrobbler for mpd).\n\n## Reference\n\nFirst and foremost, the reference to the awesome projects:\n\n[Music Player Daemon](https://www.musicpd.org/)  \n[MPDScribble](https://www.musicpd.org/clients/mpdscribble/)\n\n## Links\n\nSource: [GitHub](https://github.com/giof71/mpd-scrobbler-docker)  \nImages: [DockerHub](https://hub.docker.com/r/giof71/mpd-scrobbler)\n\n## Why\n\nI 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.\n\n## Prerequisites\n\nYou 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).\n\nYou can verify whether your user belongs to the \"docker\" group with the following command:\n\n`getent group | grep docker`\n\nThis command will output one line if the current user does belong to the \"docker\" group, otherwise there will be no output.\n\nThe Dockerfile and the included scripts have been tested on the following distros:\n\n- Manjaro Linux with Gnome (amd64)\n- Asus Tinkerboard\n- Raspberry Pi 3 and 4, both 32 and 64 bit\n\nAs I test the Dockerfile on more platforms, I will update this list.\n\n## Get the image\n\nHere is the [repository](https://hub.docker.com/repository/docker/giof71/mpd-scrobbler) on DockerHub.\n\nGetting the image from DockerHub is as simple as typing:\n\n`docker pull giof71/mpd-scrobbler`\n\nYou may want to pull the \"stable\" image as opposed to the \"latest\".\n\n## Usage\n\nYou can start mpd-scrobbler by simply typing:\n\n```text\n    docker run -d --rm \\\n        -e LASTFM_USERNAME=lastfmuser \\\n        -e LASTFM_PASSWORD=lastfmpassw \\\n        -e MPD_HOSTNAME=mpd-hostname \\\n        -e MPD_PORT=6600 \\\n        giof71/mpd-scrobbler\n```\n\n### Environment Variables\n\nThe following tables reports all the currently supported environment variables.\n\nVARIABLE|NOTES\n:---|:---\nUSER_MODE|Enables user mode if set to `YES`\nPUID|Run using this User id. Defaults to `1000`.\nPGID|Run using this Group id. Defaults to `1000`.\nMPD_HOST|The host running MPD, possibly protected by a password(`[PASSWORD@]HOSTNAME`). Defaults to `localhost`. Leave blank or `localhost` when running in `network=host` mode.\nMPD_PORT|The port that the `MPD` listens on and `mpdscribble` should try to connect to. Defaults to `6600`, the default `MPD` port.\nSCRIBBLE_VERBOSE|How verbose `mpdscribble`'s logging should be. Defaults to `1`.\nLASTFM_USERNAME|Username for `Last.fm`\nLASTFM_PASSWORD|Password for `Last.fm`\nLIBREFM_USERNAME|Username for `Libre.fm`\nLIBREFM_PASSWORD|Password for `Libre.fm`\nJAMENDO_USERNAME|Username for `Jamendo`\nJAMENDO_PASSWORD|Password for `Jamendo`\nPROXY||Proxy support for `mpdscribble`. Example value: `http://the.proxy.server:3128`\nSTARTUP_DELAY_SEC|Delay before starting the application, defaults to `0`\n\n### Volumes\n\nVolume|Description\n:---|:---\n/app/scribble/log|Where `mpdscribble` will write its journals and its log file\n\n## Notable changes to the configuration\n\n### Changes to Environment Variables\n\nA few environment variables have been deprecated, see the following table.\n\nDeprecated Variable|Deprecated Since|Comment\n---|---|---\nUSE_MPD_PASSWORD|2022-10-21|Removed variable: the `MPD` password must be specified with MPD_HOSTNAME if needed\nUSE_MPD_PASSWORD|2021-11-27|This variable is not required anymore: just set the MPD_PASSWORD variable\n\n### Changes to volumes\n\nDate|Description\n:---|:---\n2023-03-03|The log volume is now `/app/scribble/log` instead of `app/scribble`\n\n## Build\n\nYou can build (or rebuild) the image by opening a terminal from the root of the repository and issuing the following command:\n\n`docker build . -t giof71/mpd-scrobbler`\n\nIt will take very little time even on a Raspberry Pi. When it's finished, you can run the container following the previous instructions.  \nJust be careful to use the tag you have just built.\n\n## Change History\n\nChange Date|Major Changes\n---|---\n2022-10-24|Support for daily builds\n2022-10-24|Bugfix (wrong variable references and missing permissions)\n2022-10-21|Run with unprivileged user\n2022-10-21|Switch to `mpdscribble`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiof71%2Fmpd-scrobbler-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgiof71%2Fmpd-scrobbler-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiof71%2Fmpd-scrobbler-docker/lists"}