docs / providers / listenbrainz
Providers · chapters · 21 of 25
ListenBrainz
Your listening stats, top charts and playlists from ListenBrainz, and scrobbling to it.
facts
- status
- beta
- kind
- scrobbling
- on by default
- yes
- needs
- ListenBrainz account, User token
- platforms
- iPhone, iPad, Mac, Vision Pro, Apple TV, Android, Android TV, Linux, FreeBSD, Windows
Description
ListenBrainz is an open service that keeps a record of what you listen to. With this plugin Yafmp does three things.
- Scrobbling. “Now playing” is sent when a track starts. The listen is sent once the track has played for half its length or four minutes, whichever comes first. This works for every source.
- Stats dashboard. The ListenBrainz page in the library shows your total listens, a chart of listens over time, your recent listens, and your top artists, albums and tracks for a period you choose, from This Week to All Time.
- Rows in the library. Recent Listens, Top Tracks, Top Albums, Top Artists, Loved, Created for You and Playlists. ListenBrainz has no audio, so these play from your own library: songs are matched by title and artist, albums and artists by name.
Requirements
- A ListenBrainz account.
- The account’s user token.
Setup
- Sign in at
listenbrainz.org/settingsand copy your User Token.- Android and desktop: Get your token opens that page, and a QR code opens it on your phone.
- Open Preferences → Plugins → ListenBrainz (Apple) or Settings → ListenBrainz (Android and desktop).
- Paste the token into User Token and choose Sign In.
- Yafmp shows your account, and the ListenBrainz rows appear in the library.
Settings
| Setting | Default | What it does |
|---|---|---|
| User Token | — | The token from listenbrainz.org/settings. Shown while signed out. |
| Sign In | — | Checks the token and signs in. |
| Account | — | The ListenBrainz user you send listens as. Read-only. On Android and desktop it reads Scrobbling as and the name. |
| Sign Out | — | Forgets the token and stops sending listens. |
The token is kept in the system keychain (Apple) or the app’s private storage (Android and desktop).
Limits
- Tracks of 30 seconds or less are never sent.
- A track with no artist is not sent.
- Rows, charts and playlists play only what Yafmp can find in your own library. Songs it can’t match are skipped.
- Radio streams have no length, so they are not sent.
Troubleshooting
| Problem | Why | What to do |
|---|---|---|
| “That token isn’t valid” | The token was mistyped or has been reset | Copy the token again from listenbrainz.org/settings. |
| “Couldn’t send listens (N waiting)” (Apple) or “Couldn’t send (N waiting)” (Android and desktop) | The device is offline or ListenBrainz can’t be reached | Nothing. The listens are saved and sent with the next one that gets through. |
| A playlist plays fewer songs than it lists | Songs that are not in your library are skipped | Add the missing music to one of your sources. |
| A chart panel says “Not calculated yet” | ListenBrainz returned no listens for that period | Pick another period. |