multi-scrobbler

一个JavaScript应用，用于将音乐播放记录（scrobble）同步到Maloja、Last.fm和ListenBrainz。

镜像概述和主要用途

multi-scrobbler是一款跨平台音乐播放记录同步工具，通过直接与服务API通信，实现从多种音乐播放来源（Sources）到多个记录客户端（Clients）的无缝同步。无论在何处播放音乐，都能统一管理播放历史，支持多用户配置，并提供Web界面进行状态监控和日志查看。

核心功能和特性

支持多种音乐来源（Sources）

• Spotify
• Plex
• Subsonic兼容API（如Navidrome）
• Jellyfin
• WebScrobbler
• *** Music
• Last.fm
• ListenBrainz
• Deezer
• MPRIS (Linux桌面)
• Mopidy
• JRiver
• Kodi
• Google Cast (Chromecast)
• Musikcube

支持多种记录客户端（Clients）

• Maloja
• Last.fm
• ListenBrainz

其他核心特性

• 通过Webhook（Gotify、Ntfy、Apprise）或健康检查端点监控来源和客户端状态
• 支持单用户或多用户配置（为亲友同步播放记录）
• Web服务器界面，提供统计数据、基本控制和详细日志
• 网络和客户端故障的优雅处理（排队记录并自动重试）
• 安全的凭证管理（持久化存储，通过应用授权）
• 支持环境变量或JSON配置

使用场景和适用范围

为什么选择multi-scrobbler？

• 跨平台无关性：直接与服务API通信，无论在何处播放音乐（手机、电脑、智能设备）均可同步，无需在每个平台安装应用
• 开源透明：完全开源，可查看数据处理流程，保障个人数据安全
• 多来源统一管理：从多个来源同步到一个客户端，避免重复记录
• 多用户管理：为亲友同步播放记录，无需他们进行额外设置，可将来源与特定客户端关联以保持记录独立

已在使用Last.fm/ListenBrainz的用户是否需要？

是！可将Last.fm作为来源或ListenBrainz作为来源，将现有记录转发到其他客户端，保留现有设置的同时，实现数据同步到自托管服务（如Maloja）。

工作原理

multi-scrobbler通过配置来源（Source） 和客户端（Client） 工作：

• 来源（Source）：提供播放记录的音乐平台或播放器（如Spotify、Plex），包含名称、认证信息及可选的目标客户端列表（未指定则同步到所有客户端）
• 客户端（Client）：接收播放记录的服务（如Last.fm、Maloja），包含名称和认证信息

系统监控所有配置的来源，当检测到新播放记录时，将其同步到关联的客户端。

使用方法和配置说明

Docker部署示例

基本运行命令

bash
docker run -d \
  --name multi-scrobbler \
  -p 9078:9078 \
  -v /path/to/config:/app/config \
  -v /path/to/data:/app/data \
  foxxmd/multi-scrobbler

参数说明

• -p 9078:9078：映射Web界面端口（默认9078）
• -v /path/to/config:/app/config：挂载配置目录（存放JSON配置文件）
• -v /path/to/data:/app/data：挂载数据目录（存放凭证、日志等）

配置方式

• 配置文件：在/app/config目录下创建config.json，按***文档格式配置来源和客户端
• 环境变量：支持通过环境变量设置基础配置，详细变量列表见***配置文档

访问Web界面

启动后，通过http://localhost:9078访问Web界面，查看统计数据、日志及进行基础控制。首次启动可能需要通过Web界面完成来源/客户端的授权流程。

更多信息

• 完整配置指南：***文档
• 支持的来源和客户端详细配置：配置说明
• 健康检查端点：http://localhost:9078/health
• Webhook配置：支持Gotify、Ntfy、Apprise等通知服务，详见Webhook文档