Skip to content

Setup: Scrobblers (Optional)

Arthur Jamet edited this page May 22, 2025 · 2 revisions

From v3.5.0 (or e3b030d), Meelo can push your play history to LastFM and ListenBrainz. Follow these instructions to set up either of these Scrobbling Services.

LastFM

.env file

Create an API account on LastFM using this form:

  • Use your email address
  • Set Application name to whatever you like
  • You can leave Application description, Callback url and Application Homepag empty

Once this is done, you should see an API key and secret. Set them in your .env file to the LASTFM_API_KEY and LASTFM_API_SECRET values respectively.

Remember to restart your Meelo server to apply the changes.

Link user account

  • In Meelo's settings page, in the Scrobblers section, a LastFM button should be visible.
  • When clicking it, you should be redirected to a LastFM webpage.
  • Click the Accept button.
  • If everything went well, you should be redirected back to Meelo's settings page, and the LastFM Button should be red.

ListenBrainz

  • In Meelo's settings page, in the Scrobblers section, a ListenBrainz button should be visible.
  • When clicking it, a form should open
    • Set the User token field to the token found on the ListenBrainz's setting page (more info here)
    • If you use a self-hosted instance of ListenBrainz, enter the Url or the API of the instance in the second field
      • Otherwise, leave the field empty
  • If everything went well, a pop-up should confirm that your account was linked successfully.

Further notes

Caution

Be careful: In the settings' page, when a scrobbler button is red, your account is linked. Clicking it will unlink your scrobbler account.

  • We follow LastFM's definition of a scrobble
  • Scrobbles are pushed every 5 minutes
  • When you connect a scrobbling service to your Meelo user account, all your scrobbles from Meelo will be pushed.

Clone this wiki locally