foxxmd/multi-scrobbler

multi-scrobbler

一个JavaScript应用，用于将音乐播放记录（scrobble）同步到https://github.com/krateng/maloja%E3%80%81Last.fm%E5%92%8CListenBrainz%E3%80%82

镜像概述和主要用途

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

核心功能和特性

支持多种音乐来源（Sources）

• https://foxxmd.github.io/multi-scrobbler/docs/configuration#spotify
• https://foxxmd.github.io/multi-scrobbler/docs/configuration#plex
• https://foxxmd.github.io/multi-scrobbler/docs/configuration#subsonic%EF%BC%88%E5%A6%82Navidrome%EF%BC%89
• https://foxxmd.github.io/multi-scrobbler/docs/configuration#jellyfin
• https://foxxmd.github.io/multi-scrobbler/docs/configuration#webscrobbler
• https://foxxmd.github.io/multi-scrobbler/docs/configuration#***-music
• https://foxxmd.github.io/multi-scrobbler/docs/configuration#lastfm-source
• https://foxxmd.github.io/multi-scrobbler/docs/configuration#listenbrainz-source
• https://foxxmd.github.io/multi-scrobbler/docs/configuration#deezer
• https://foxxmd.github.io/multi-scrobbler/docs/configuration#mpris
• https://foxxmd.github.io/multi-scrobbler/docs/configuration#mopidy
• https://foxxmd.github.io/multi-scrobbler/docs/configuration#jriver
• https://foxxmd.github.io/multi-scrobbler/docs/configuration#kodi
• https://foxxmd.github.io/multi-scrobbler/docs/configuration#google-cast-chromecast
• https://foxxmd.github.io/multi-scrobbler/docs/configuration#musikcube

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

• https://foxxmd.github.io/multi-scrobbler/docs/configuration#maloja
• https://foxxmd.github.io/multi-scrobbler/docs/configuration#lastfm
• https://foxxmd.github.io/multi-scrobbler/docs/configuration#listenbrainz

其他核心特性

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

使用场景和适用范围

为什么选择multi-scrobbler？

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

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

是！可将https://foxxmd.github.io/multi-scrobbler/docs/configuration#lastfm-source%E6%88%96https://foxxmd.github.io/multi-scrobbler/docs/configuration#listenbrainz-source%EF%BC%8C%E5%B0%86%E7%8E%B0%E6%9C%89%E8%AE%B0%E5%BD%95%E8%BD%AC%E5%8F%91%E5%88%B0%E5%85%B6%E4%BB%96%E5%AE%A2%E6%88%B7%E7%AB%AF%EF%BC%8C%E4%BF%9D%E7%95%99%E7%8E%B0%E6%9C%89%E8%AE%BE%E7%BD%AE%E7%9A%84%E5%90%8C%E6%97%B6%EF%BC%8C%E5%AE%9E%E7%8E%B0%E6%95%B0%E6%8D%AE%E5%90%8C%E6%AD%A5%E5%88%B0%E8%87%AA%E6%89%98%E7%AE%A1%E6%9C%8D%E5%8A%A1%EF%BC%88%E5%A6%82Maloja%EF%BC%89%E3%80%82

工作原理

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，按https://foxxmd.github.io/multi-scrobbler/docs/configuration%E6%A0%BC%E5%BC%8F%E9%85%8D%E7%BD%AE%E6%9D%A5%E6%BA%90%E5%92%8C%E5%AE%A2%E6%88%B7%E7%AB%AF
• 环境变量：支持通过环境变量设置基础配置，详细变量列表见https://foxxmd.github.io/multi-scrobbler/docs/configuration#environment-variables

访问Web界面

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

更多信息

• 完整配置指南：https://foxxmd.github.io/multi-scrobbler/docs/configuration
• 支持的来源和客户端详细配置：https://foxxmd.github.io/multi-scrobbler/docs/configuration
• 健康检查端点：http://localhost:9078/health
• Webhook配置：支持Gotify、Ntfy、Apprise等通知服务，详见https://foxxmd.github.io/multi-scrobbler/docs/configuration#webhook-configurations