Find a file
FoxxMD d164f568a4
Some checks failed
CI / Test, Build and Smoke Test (amd64) (push) Has been cancelled
CI / Test, Build and Smoke Test (arm64) (push) Has been cancelled
CI / Publish (push) Has been cancelled
docs: better guidance for lastfm backup tools
2026-11-19 12:16:11 -05:00
.devcontainer feat: Migrate eslint to oxlint 2026-11-17 18:37:07 +00:00
.github ci: Clean up pr comment 2026-11-09 21:07:39 +00:00
.storybook chore(storybook): upgrade msw-storybook-addon to v3 2026-11-18 20:04:58 +00:00
.vscode enable oxlint in vscode workspace 2026-11-17 18:58:53 +00:00
assets refactor(discord): Update links and art 2026-02-17 21:05:26 +00:00
config feat: Implement MVP blackbox scrobble client 2026-11-16 13:23:30 +00:00
deploy chore: Add kasm service as extenable compose file for dev 2026-02-26 19:12:21 +00:00
docsite docs: better guidance for lastfm backup tools 2026-11-19 12:16:11 -05:00
flatpak docs: replace docusaurus with starlight 2026-10-27 12:54:54 +00:00
patches chore: bump sqlite-up, remove patch, and use better frontend analyzer 2026-10-05 14:29:06 +00:00
public fea(ui): Implement tanstack-query for ActivityDetails and mock in storybook 2026-06-10 20:44:51 +00:00
src chore(storybook): upgrade msw-storybook-addon to v3 2026-11-18 20:04:58 +00:00
.dockerignore docs: replace docusaurus with starlight 2026-10-27 12:54:54 +00:00
.env.example feat: Improved persistent directory support 2026-09-24 13:46:39 +00:00
.gitignore feat: Migrate eslint to oxlint 2026-11-17 18:37:07 +00:00
.lnav.config.json docs: Add lnav config 2024-12-27 18:49:29 +00:00
.mocharc.json test: setup tests to run in parallel 2026-11-16 13:54:57 -05:00
.nvmrc chore: regenerate lockfile with newer npm to get correct libc deps 2026-11-16 19:49:22 +00:00
cliff.toml chore: Update git-cliff workflow 2026-02-11 15:24:54 +00:00
CODE_OF_CONDUCT.md Add Contributor Covenant Code of Conduct 2026-03-27 13:15:33 -04:00
CONTRIBUTING.md chore: Refactor git/dev workflow to use master as unstable branch 2024-08-30 09:53:52 -04:00
docker-compose.dev.yml feat!: Move to a distroless docker image 2026-11-09 15:47:35 -05:00
docker-compose.yml feat!: Move to a distroless docker image 2026-11-09 15:47:35 -05:00
Dockerfile chore: Remove unnessary drizzle-kit prod dependency 2026-11-16 19:31:05 +00:00
drizzle.config.ts fix: Move project root dir constant location into backend-only scope 2026-07-22 15:40:44 +00:00
embed.html feat(ui): Add embeddable public dashboard 2026-11-06 17:07:32 +00:00
index.html partial working subpath 2026-09-14 15:48:38 +00:00
LICENSE Create LICENSE 2020-12-06 21:51:20 -05:00
oxlint.config.ts feat: add oxlint shared config for fixing unused imports 2026-11-17 18:51:01 +00:00
oxlint.typeImports.config.ts feat: Migrate eslint to oxlint 2026-11-17 18:37:07 +00:00
oxlint.unusedImports.config.ts feat: add oxlint shared config for fixing unused imports 2026-11-17 18:51:01 +00:00
package-lock.json chore(storybook): upgrade msw-storybook-addon to v3 2026-11-18 20:04:58 +00:00
package.json chore(storybook): upgrade msw-storybook-addon to v3 2026-11-18 20:04:58 +00:00
README.md chore(release): Bump version for release 2026-11-17 19:34:25 +00:00
tsconfig.json add allowImportingTsExtensions compiler option 2026-07-09 02:03:03 +00:00
vite.config.ts feat(ui): Add embeddable public dashboard 2026-11-06 17:07:32 +00:00

multi-scrobbler

Latest Release License: MIT Docker Pulls Docs

multi-scrobbler logo

A dockerized app that monitors your music listening activity from everywhere and scrobbles it anywhere.

Quick Start Guide

More Screenshots

Why should I use this over a browser extension and/or mobile app scrobbler?

  • Platform independent -- Because multi-scrobbler communicates directly with service APIs it will scrobble everything you play regardless of where you play it. No more need for apps on every platform you use!
  • Open-source -- Get peace of mind knowing exactly how your personal data is being handled.
  • Track your activity regardless of where you listen -- Scrobble from many Sources to one Client with ease and without duplicating tracks.
  • Manage scrobbling for others -- Scrobble for your friends and family without any setup on their part. Easily silo sources to specific clients to keep plays separate.

But I already scrobble my music to Last.fm/ListenBrainz, is multi-scrobbler for me?

Yes! You can use Last.fm as a Source or Listenbrainz as a Source to forward scrobbles from your profile to any other Client! That way you can keep your current scrobble setup as-is but still get the benefit of capturing your data to a self-hosted location.

How Does multi-scrobbler (MS) Work?

You set up configurations for one or more Sources and one or more Clients. MS monitors all of your configured Sources. When new tracks are played by a Source MS grabs that information and then sends it (scrobbles it) to all Clients that Source is configured to forward to.

Source

A Source is a data source that contains information about music you are playing or have listened to, such as: a desktop player, web music player, or cloud music service. Examples are Spotify, Jellyfin, Plex, Youtube Music, Navidrome, etc...

Source configurations consist of:

  • A friendly name.
  • Any data needed to communicate or authenticate with the Source.
  • An optional list of Client names that the Source should scrobble to. If omitted the Source also scrobbles to all configured Clients.

Client

A Client is an application that stores the historical information about what music you have played (scrobbles). Examples are Koito, Last.fm, Listenbrainz...

Client configurations consist of:

  • A friendly name.
  • Any data needed to communicate or authenticate with the Client.

Quick Start

See the Quick Start Guide

Installation

See the Installation documentation

Configuration

See the Configuration documentation

Usage

A status page with statistics, recent logs, and some runtime configuration options can be found at

http://localhost:9078

Output is also provided to stdout/stderr as well as file if specified in configuration.

On first startup you may need to authorize Spotify and/or Last.fm by visiting the callback URL (which can also be accessed from the status page). Visit the status page above to find the applicable link to trigger this.

Help/FAQ

Having issues with connections or configuration? Check the FAQ before creating an issue!

Development

Detailed architecture and development guides for Sources/Clients

License

MIT