Last.fm

Other Users

• To monitor and re-scrobble activity from your Last.fm/Libre.fm account create a Last.fm (Source)
• To accept scrobbles from outside applications as if multi-scrobbler was Last.fm, create a Last.fm (Endpoint)

Limits for Old Scrobbles

Last.fm will not accept scrobbles that are timestamped as older than 2 weeks from the current time.

This is not officially documented but has been confirmed by multiple people/mods in the last.fm support forums: [1] [2] [3]

Multi-scrobbler can queue scrobbles for you if the Last.fm service is unavailable, or if there is an issue with a specific scrobble. However, you are responsible for making sure these scrobbles are eventually sent to Last.fm (by retrying in the UI or retarting Last.fm client in UI) before the two week window has passed or else they will not be scrobblable at all unless the timestamp is changed.

A future update to Multi-scrobbler will enable editing of unsent scrobble data and modifying the timestamp from the UI.

If you have issues with specific scrobbles not being sent and retries/restarts do not fix it, please make sure to create a new issue in a timely manner so that it can be resolved before the window has passed.

You will need a Last.fm account to use the Last.fm API.

After creating your account, register for an API account here.

The callback URL in the API account form is not used, but to keep it consistent use the same value you set using the Callback/Redirect URL section.

Take note of your API Key and Secret after account creation.

Callback/Redirect URL

The Redirect (Callback) URL is used to redirect your browser to multi-scrobbler after authentication has completed.

So, the base of the URL you use should be the same as the URL you would use to navigate to the multi-scrobbler dashboard.

Example

If you can visit the multi-scrobbler dashboard by navigating to http://192.168.0.100:9078 in your web browser…

then the ENV LASTFM_REDIRECT_URI, or redirectUri for last.fm/libre.fm json config, should be

http://YOUR_MS_DOMAIN/lastfm/callback

The Redirect URL can be explicitly specified in the configuration below, or by using the global Base URL setting.

Configuration

ENV

Configuration Type

This is configuration for the ENV Config Type.

Environmental Variable	Type	Default	Description
LASTFM_ID	string		A globally unique ID EX myComponentId
LASTFM_NAME	string	Value of LASTFM_ID	A vanity name EX My Cool Component
LASTFM_ENABLE	boolean	true	Should this component be used?
LASTFM_API_KEY	string		API Key generated from Last.fm/Libre.fm account
LASTFM_SECRET	string		Secret generated from Last.fm/Libre.fm account
LASTFM_REDIRECT_URI	string	http://localhost:9078/lastfm/callback	Optional URI to use for callback.
LASTFM_SESSION	string		Optional session id returned from a completed auth flow

Bold/Italic = Required

File

Config Structure

This displays the structure of the File Configuration for a lastfm type Client with all possible properties, their shape, and descriptions/types. Use this to understand how to write a valid config.

Config Example

This displays an example config file of a lastfm Client File Configuration that adheres to the shown Config Structure.

• text mode lets you edit the JSON directly.
• tree mode gives you a guided point-and-click editing experience that always keeps the JSON syntax valid.

Both modes validate that the configuration is correct. Any errors show up as squiggly lines.

Important

Only client lastfm configs will validate correctly in the editor but both source and client lastfm configs are allowed in the real CONFIG/lastfm.json

After you finish editing, switch to text and then copy all text to get a completed config.

Config Example Mobile Experience

This displays an example config file of a lastfm Client File Configuration that adheres to the shown Config Structure.

The example config file editor is meant for a larger screen experience so only the read-only example is shown. Please use this site on a tablet/laptop/desktop to enable file editor features.

CONFIG/lastfm.json

[
  {
    "id": "myLastFmClient",
    "name": "Foxx LFM Client",
    "data": {
      "apiKey": "a89cba1569901a0671d5a9875fed4be1",
      "secret": "ec42e09d5ae0ee0f0816ca151008412a",
      "redirectUri": "http://localhost:9078/lastfm/callback"
    },
    "configureAs": "client",
    "enable": true
  }
]

AIO

Config Structure

This displays the structure of the all-in-one (config.json) configuration with all possible properties, their shape, and descriptions/types. Use this to understand how to write a valid config.

Select the lastfm type from the respective clients node below, then expand it.

Config Example

This displays an example config file of a all-in-one (config.json) configuration that includes a lastfm Client that adheres to the shown Config Structure.

• text mode lets you edit the JSON directly.
• tree mode gives you a guided point-and-click editing experience that always keeps the JSON syntax valid.

Both modes validate that the configuraion is correct. Any errors show up as squiggly lines.

After you finish editing, switch to text and then copy all text to get a completed config.

Config Example Mobile Experience

This displays an example config file of a all-in-one (config.json) configuration that includes a lastfm Client that adheres to the shown Config Structure.

The example config file editor is meant for a larger screen experience so only the read-only example is shown. Please use this site on a tablet/laptop/desktop to enable file editor features.

CONFIG/config.json

{
  "clients": [
    {
      "type": "lastfm",
      "id": "myLastFmClient",
      "name": "Foxx LFM Client",
      "data": {
        "apiKey": "a89cba1569901a0671d5a9875fed4be1",
        "secret": "ec42e09d5ae0ee0f0816ca151008412a",
        "redirectUri": "http://localhost:9078/lastfm/callback"
      },
      "configureAs": "client",
      "enable": true
    }
  ]
}