Skip to main content

From < 0.14.0

Required Upgrade

You MUST upgrade to this version before upgrading Multi-Scrobbler to a newer version.

This version contains functionality to migrate your data from < 0.14.0 that newer versions depend on.

Upgrade Process Example
  • Upgrade Multi-Scrobbler 0.13.2 to 0.14.0
  • After upgrading, you can optionally upgrade to > 0.14.0

Source/Client IDs​

MS 0.14.0 introduces a database for persisting Plays/Scrobbles, queues, and other data associated with a Source/Client.

To make this association atomic a Source/Client ID is now configurable. This ID is what MS will use to identify the Source/Client in your config with the Source/Client in the database.

This ID needs to be unique to the client or source type it is used on IE:

  • two Koito Clients cannot both have the ID myKoitoID
  • it is recommended that the ID be globally unique among all sources/clients, but it's not required

Configuring IDs​

For each Source/Client in your environmental variables, add a key with the suffix _ID and the ID value. EX

compose.yaml
services:
  multi-scrobbler:
  # ...
  environment:
    - KOTIO_TOKEN=...
    # ...more koito config
    - KOITO_ID=myKoitoID

    - JELLYFIN_URL=...
    # ...more jellyin config
    - JELLYFIN_ID=myJellyfinID
Default ID

If you do not add an ID then Multi-Scrobbler will automatically use the name of the Source/Client as the ID. The name is shown in the Dashboard.

If you decide to add an ID later you must use the name as the ID in order to keep Plays/Scobbles associated with the same config.

Cached Scrobble Migration​

tip

Before upgrading, if your MS dashboard shows 0 queued/failed for all Scrobble Clients then you can ignore this step.

MS 0.14.0 introduces a database for persisting Plays/Scrobbles, queues, and other data. Prior to 0.14.0, queued/failed scrobbles were stored in a cache file inside your CONFIG_DIR named ms-scrobble.cache.

When a Client is created and enabled in 0.14.0 it will attempt to automatically migrate scrobbles from this cache into the database.

  • You can see progress/results for this process by filtering logs for [Cached Scrobble Migration]
  • If the process fails MS will attempt to migrate failed scrobbles, again, the next time it is started
  • Your cached scrobbles are not deleted in either the success or failure outcome
    • If the process succeeds then MS knows to ignore the cache on subsequent startups
note

This process only occurs for Clients that are enabled.

  • If you are using ENV for config then your Clients are automatically enabled
  • If you are using File/AIO make sure that the enable property is either true or not present in your Client configs

Even if your Client does not start successfully (EX due to authentication) you should still enable and start all Clients in order to get all scrobbled migrated.

Cache Configuration​

In 0.14.0 Cache has been simplified with much of the required configuration being removed.

tip

This only applies to users who have cache in their AIO Config config.json or are using CACHE_* ENV Config

If you do not have any of the above Cache configuration defined then you can ignore this step.

Scrobble Caching Removed​

Scrobble caching has removed and replaced by the new database.

  • Remove any ENV Config starting with CACHE_SCROBBLE
  • Remove cache.scrobble from the AIO Config

Metadata Config Simplified​

Metadata caching remains the same but the config has been simplified. If you were using Valkey for caching update your config:

  • Remove CACHE_METADATA
  • Rename CACHE_METADATA_CONN to CACHE_VALKEY

Auth Config Simplified​

Auth caching remains the same but the config has been simplified. The connection option for Auth is no longer configurable. You may specify provider as either file (default, uses CONFIG_DIR) or valkey. If you want to use Valkey for auth it will use the same config as Metadata.

Renamed ENV Keys​

In an effort to standard ENV prefixes some ENV keys have been renamed:

  • LZENDPOINT_ENABLE => LZE_ENABLE
  • LFMENDPOINT_ENABLE => LFM_ENABLE