thrash.dev

docs / providers / listenbrainz

Providers · chapters · 21 of 25

← Yafmp manual

  1. Local Files
  2. Plex
  3. Navidrome
  4. Jellyfin
  5. Bandcamp
  6. Lidarr
  7. Apple Music
  8. Spotify
  9. SoundCloud
  10. YouTube Music
  11. SiriusXM
  12. Radio
  13. Podcasts
  14. AirPlay
  15. Chromecast
  16. MusicBrainz
  17. Discogs
  18. Labels
  19. Releases
  20. Last.fm
  21. ListenBrainz
  22. Connect
  23. Home Assistant
  24. MCP server
  25. DJ

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

  1. Sign in at listenbrainz.org/settings and copy your User Token.
    • Android and desktop: Get your token opens that page, and a QR code opens it on your phone.
  2. Open Preferences → Plugins → ListenBrainz (Apple) or Settings → ListenBrainz (Android and desktop).
  3. Paste the token into User Token and choose Sign In.
  4. Yafmp shows your account, and the ListenBrainz rows appear in the library.

Settings

SettingDefaultWhat 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

ProblemWhyWhat to do
“That token isn’t valid”The token was mistyped or has been resetCopy 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 reachedNothing. The listens are saved and sent with the next one that gets through.
A playlist plays fewer songs than it listsSongs that are not in your library are skippedAdd the missing music to one of your sources.
A chart panel says “Not calculated yet”ListenBrainz returned no listens for that periodPick another period.