YourSpotify
自托管的 Spotify 听歌统计面板，记录并可视化你的音乐播放历史。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
自建 Spotify 听歌统计，隐私无忧
核心功能
- 自动记录 Spotify 播放历史（24 小时轮询）
- Web 仪表盘展示统计：歌曲 / 歌手 / 风格排行、时间趋势
- 支持导入 Spotify 隐私数据文件，补全过去一年的记录
- 数据全面自托管，不依赖第三方服务
- 支持 Docker Compose 一键部署
避坑指南
- •需要 Spotify 高级账户才能获取完整历史；首次使用只能记录之后的数据，过去的数据需手动导入隐私数据包；MongoDB 版本建议用 4.4（ARM 设备避免 5.x 以上）；默认时区是欧洲/巴黎，需自行修改 TIMEZONE。
适用场景
- 想深度了解自己听歌习惯的 Spotify 重度用户
- 出于隐私考虑，不想让第三方平台分析自己数据的用户
- 运营音乐相关社群，需要可视化数据分析
详细介绍
YourSpotify 是一款自托管的 Spotify 听歌统计工具。它会定时从 Spotify API 拉取你的播放记录，并在 Web 控制台中以图表形式展示你的音乐偏好，包括最爱歌曲、歌手、风格以及时间趋势。数据存储在本地 MongoDB 中，并支持导入 Spotify 官方提供的隐私数据来补全历史记录。适合注重隐私、不想把数据交给第三方平台的用户。
常见问题与排障 (2)
故障排除为什么 Spotify Full Privacy 导入播客和有声读物条目时会失败，并显示“expected string, received null”错误？
导入验证期望非空的'master_metadata_track_name'和'spotify_track_uri'，但Spotify的扩展流媒体历史导出包含这些字段为null的播客/有声书条目。作为替代方案，请预处理您的文件以过滤掉这些记录：
python
import json
with open('Streaming_History_Audio_2024-2025_0.json') as f:
data = json.load(f)
cleaned = [r for r in data if r.get('master_metadata_track_name') is not None]
with open('cleaned.json', 'w') as f:
json.dump(cleaned, f)
然后导入'cleaned.json'。或者，升级到Your Spotify v1.18.0或更高版本，其中可能包含修复。
故障排除为什么服务器在请求 Spotify tracks API 时会收到 403 Forbidden 错误？
403错误表明存在身份验证或授权问题，通常是由于访问令牌无效或权限范围不足所致。此特定问题已在后续服务器版本中得到修复。请更新至可用的最新版本。若更新后问题仍然存在，请仔细检查您的Spotify应用凭据和所需权限，然后提交新的问题以获取进一步帮助。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：在 Spotify Developer Dashboard 创建一个应用，获取 Client ID 和 Secret
步骤2：复制 docker-compose-example.yml，修改环境变量（API端点、Spotify凭据）
步骤3：运行 docker-compose up -d，访问 http://localhost:3000 开始使用
- 步骤1：在 Spotify Developer Dashboard 创建一个应用，获取 Client ID 和 Secret
- 步骤2：复制 docker-compose-example.yml，修改环境变量（API端点、Spotify凭据）
- 步骤3：运行 docker-compose up -d，访问 http://localhost:3000 开始使用
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
删除 Docker 容器和卷：docker-compose down -v，然后删除 youspotify_db 数据目录。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
2 FAQs