Version 0.4.0 is a functionally-equivalent rewrite of multi-scrobbler in Typescript with many internal updates and docker improvements.

Changes were made with an effort to prevent any functional breaking changes but there may still be changes required for Docker users and building the application for native installs.

Migrating from <0.4.0

Native (Local Installs)

• Minimum Node version has been changed to 18. (Tip: Use nvm to manage node version)
• Typescript is required to build multi-scrobbler but this is all taken care of with npm scripts:
  • npm install && npm run build && npm run start
• LOG_DIR is no longer used. Log files will now always be stored under CONFIG_DIR/logs

Docker

• The container still uses CONFIG_DIR as the configuration file directory BUT it now defaults to /config if CONFIG_DIR is not present. See the updated Docker install instructions for configuring this, if needed.
  • LOG_DIR is no longer used. Log files will now always be stored under CONFIG_DIR/logs
• If you run Docker on a Linux host (ubuntu, fedora, arch, etc...) it is highly recommended to set the environmental variables PUID and PGID in order to prevent file permission issues. See the Linux Host instructions in the installation docs.

Changelog

Features

• Rewritten using typescript 4.9.5
• Ingress-based source (Plex/Tautulli/Jellyfin) have better/more logging for initial connections to help with troubleshooting
• Improved jellyfin track play data standardization and logging
• Improved debug logging for Memory-Source based sources (subsonic)
• A docker-compose file is now provided
• Docker image updated
  • Updated base image
  • Simplified volumes and volume paths
  • Respects host file permissions using PUID and PGID env variables

Bug Fixes

• Fixed spotify authentication when using multiple-env based sources #63
• Fixed jellyfin source play data error #61 thanks @CPU-Blanc
• Fixed plex payload parsing and added additional debug logging #40

Documentation

• Added docker-compose usage, improved docker install instructions, and added TZ usage #55 thanks @iluvatyr
• Added missing jellyfin kitchensink usage and fixed documentation inconsistencies thank @sirjmann92
• Added auto-generated json schema for all source/clients/config along with schema explorer/editor/validator to the documentation
• Cleaned up example configs and added README pointing to config docs for additional info
  • Example configs are now copied to clean config dir on docker container start #8
• Added FAQ with connection/configuration issue basic troubleshooting
• Added github issue template