moventura/sptnr

Navidrome星级评分增强镜像

镜像概述

本Docker镜像旨在为Navidrome音乐服务器提供扩展功能，通过整合Spotify和Last.fm的歌曲流行度数据，为Navidrome音乐库中的歌曲自动添加星级评分（如1-5星），从而丰富用户的音乐发现和管理体验。

核心功能与特性

• 多源数据整合：通过Spotify Web API和Last.fm API获取歌曲的流行度指标（如Spotify的popularity值、Last.fm的播放次数等）
• 自动评分映射：将外部流行度数据转换为直观的星级评分（例如：流行度80+对应5星，60-79对应4星等，评分规则可配置）
• Navidrome无缝集成：与Navidrome数据存储交互，为歌曲元数据添加评分字段，支持在Navidrome界面中显示
• 定时更新机制：可配置定时任务，定期同步最新流行度数据，保持评分时效性
• 灵活配置：支持自定义评分映射规则、API请求频率限制、数据缓存策略等

使用场景与适用范围

• 个人音乐库管理：为个人Navidrome音乐收藏添加客观的外部流行度评分，辅助音乐筛选
• 家庭音乐服务器：在家庭共享的Navidrome服务器中，通过星级评分帮助家庭成员快速识别热门歌曲
• 音乐爱好者工具：结合外部流行度数据，分析个人音乐品味与大众趋势的关联

使用方法与配置说明

前置条件

1. 拥有Spotify开发者账号，并创建应用以获取SPOTIFY_CLIENT_ID和SPOTIFY_CLIENT_SECRET（需在Spotify Developer Dashboard注册）
2. 拥有Last.fm账号，并申请API密钥LASTFM_API_KEY（需在Last.fm API页面注册）
3. 已部署Navidrome音乐服务器，且可通过网络访问其API或数据库

环境变量说明

Docker部署示例

1. 使用docker run命令部署

bash
docker run -d \
  --name navidrome-star-rater \
  -e NAVIDROME_URL="http://navidrome:4533" \
  -e NAVIDROME_USER="admin" \
  -e NAVIDROME_PASSWORD="your-navidrome-password" \
  -e SPOTIFY_CLIENT_ID="your-spotify-client-id" \
  -e SPOTIFY_CLIENT_SECRET="your-spotify-client-secret" \
  -e LASTFM_API_KEY="your-lastfm-api-key" \
  -e RATING_MAPPING="85:5,70:4,55:3,40:2,25:1" \
  -e SYNC_INTERVAL="720" \
  --restart unless-stopped \
  [镜像名称]:[标签]

2. Docker Compose配置示例

yaml
version: '3.8'

services:
  navidrome-star-rater:
    image: docker.xuanyuan.run/[镜像名称]:[标签]
    container_name: navidrome-star-rater
    environment:
      - NAVIDROME_URL=http://navidrome:4533
      - NAVIDROME_USER=admin
      - NAVIDROME_PASSWORD=your-navidrome-password
      - SPOTIFY_CLIENT_ID=your-spotify-client-id
      - SPOTIFY_CLIENT_SECRET=your-spotify-client-secret
      - LASTFM_API_KEY=your-lastfm-api-key
      - RATING_MAPPING=85:5,70:4,55:3,40:2,25:1
      - SYNC_INTERVAL=720
      - LOG_LEVEL=info
    restart: unless-stopped
    depends_on:
      - navidrome  # 确保在Navidrome启动后运行

  navidrome:
    # Navidrome服务配置（此处省略，需确保Navidrome已正确部署）
    image: docker.xuanyuan.run/deluan/navidrome:latest
    # ...其他Navidrome配置

配置参数详解

• RATING_MAPPING：定义流行度值与星级的对应关系，格式为"流行度下限:星级"，多个规则用逗号分隔。例如"80:5,60:4,40:3,20:2,0:1"表示流行度≥80为5星，60-79为4星，以此类推。
• SYNC_INTERVAL：设置数据同步周期，单位为分钟。建议根据API调用限制设置（如Spotify API有请求速率限制，避免过于频繁的同步）。
• API密钥获取：
  • Spotify：访问Spotify Developer Dashboard，创建应用后获取Client ID和Client Secret
  • Last.fm：访问Last.fm API Account Creation，注册应用后获取API Key

注意事项

• 确保Navidrome服务器与本镜像容器网络互通，且Navidrome用户具有足够权限修改歌曲元数据
• 遵守Spotify和Last.fm的API使用条款，控制请求频率以避免超出限制
• 首次运行时可能需要较长时间同步数据，具体取决于音乐库大小
• 部分歌曲可能因元数据不匹配（如标题、艺术家名称差异）导致无法获取流行度数据，可通过Navidrome手动修正元数据后重新同步