Last.fm/Libre.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)

Last.fm

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.

Libre.fm

To use the official Libre.fm instance you will need an account. Or, you can run your own Libre.fm instance using the legacy source code.

No additional API account, API Key, or Secret is needed to use the Libre.fm, unlike Last.fm.

Instead, use any values for API Key/Secret in the configuration. Authentication is done by allowing access from your account on redirect.

Enable Libre.fm/Custom

Reference the configuration below for librefm/host/path specific properties.

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://192.168.0.100:9078/lastfm/callback

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

Configuration

ENV

ENV Config Type

Environmental Variable	Required?	Default	Description
LASTFM_API_KEY	Yes		Api Key from your API Account
LASTFM_SECRET	Yes		Shared secret from your API Account
LASTFM_REDIRECT_URI	No	http://localhost:9078/lastfm/callback	Url to use for authentication. Must include lastfm/callback somewhere in it
LASTFM_SESSION	No		Session id. Will be generated by authentication flow if not provided.
LASTFM_LIBREFM_MODE	No		Set to true to use the official Libre.fm instead of Last.fm
LASTFM_HOST	No	ws.audioscrobbler.com	Use for custom Libre.fm instance only, The domain.tld for the instance
LASTFM_PATH	No	/2.0	Use for custom Libre.fm instance only, The path prefix of the URL

File

File Config Type

CONFIG/lastfm.json

[
  {
    "name": "myLastFmClient",
    "enable": true,
    "configureAs": "client",
    "data": {
      "apiKey": "a89cba1569901a0671d5a9875fed4be1",
      "secret": "ec42e09d5ae0ee0f0816ca151008412a",
      "redirectUri": "http://localhost:9078/lastfm/callback"
    }
  },
  {
    "name": "myLibreFmClient",
    "enable": true,
    "configureAs": "client",
    "data": {
      "apiKey": "anything",
      "secret": "anything",
      "librefm": true,
      "redirectUri": "http://localhost:9078/lastfm/callback"
    }
  }
]

or explore the schema with an example and live editor/validator

AIO

AIO Config Type

CONFIG_DIR/config.json

{
  "clients": [
    {
      "name": "myLastFmClient",
      "enable": true,
      "configureAs": "client",
      "data": {
        "apiKey": "a89cba1569901a0671d5a9875fed4be1",
        "secret": "ec42e09d5ae0ee0f0816ca151008412a",
        "redirectUri": "http://localhost:9078/lastfm/callback"
      },
      "type": "lastfm"
    },
    {
      "name": "myLibreFmClient",
      "enable": true,
      "configureAs": "client",
      "data": {
        "apiKey": "anything",
        "secret": "anything",
        "librefm": true,
        "redirectUri": "http://localhost:9078/lastfm/callback"
      },
      "type": "lastfm"
    }
  ]
}

or explore the schema with an example and live editor/validator