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 官方提供的隐私数据来补全历史记录。适合注重隐私、不想把数据交给第三方平台的用户。
トラブルシューティング & FAQ (2)
トラブル対応なぜSpotify Full Privacyのインポートがポッドキャストやオーディオブックのエントリに対して'expected string, received null'で失敗するのですか?
インポート検証では、'master_metadata_track_name' および 'spotify_track_uri' が null 以外であることが期待されますが、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 以降にアップグレードしてください。これには修正が含まれている可能性があります。
トラブル対応なぜserverがSpotify tracks APIをリクエストするときに403 Forbidden errorが発生するのですか?
403 errorは認証または認可の問題を示唆しており、多くの場合、無効なaccess tokenや不十分なscopesが原因です。この特定の問題は、サーバーの後のリリースで解決されました。利用可能な最新バージョンにアップデートしてください。アップデート後もエラーが続く場合は、Spotify app credentialsと必要なpermissionsを再確認し、新しいissueを開いてさらに支援を求めてください。
タグ
はじめ方
ソフトウェアをインストール
ダウンロードしたインストーラをダブルクリックし、指示に従ってください
步骤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