OpenSource-Hub
Y

YourSpotify

4.4k stars·プライバシー保護·SHA-256 チェックサム確認済み

自托管的 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 以降にアップグレードしてください。これには修正が含まれている可能性があります。

参照 Issue #582
トラブル対応
なぜserverがSpotify tracks APIをリクエストするときに403 Forbidden errorが発生するのですか?

403 errorは認証または認可の問題を示唆しており、多くの場合、無効なaccess tokenや不十分なscopesが原因です。この特定の問題は、サーバーの後のリリースで解決されました。利用可能な最新バージョンにアップデートしてください。アップデート後もエラーが続く場合は、Spotify app credentialsと必要なpermissionsを再確認し、新しいissueを開いてさらに支援を求めてください。

参照 Issue #591

タグ

spotifyself-hostedmusic-statsdashboardprivacy

はじめ方

1

インストーラをダウンロード

上のボタンをクリックして、お使いのシステム用のインストーラをダウンロード

2

ソフトウェアをインストール

ダウンロードしたインストーラをダブルクリックし、指示に従ってください

3

步骤1:在 Spotify Developer Dashboard 创建一个应用,获取 Client ID 和 Secret

4

步骤2:复制 docker-compose-example.yml,修改环境变量(API端点、Spotify凭据)

5

步骤3:运行 docker-compose up -d,访问 http://localhost:3000 开始使用

インストールガイド
  1. 步骤1:在 Spotify Developer Dashboard 创建一个应用,获取 Client ID 和 Secret
  2. 步骤2:复制 docker-compose-example.yml,修改环境变量(API端点、Spotify凭据)
  3. 步骤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 数据目录。

追加の依存関係なし

ダウンロード後すぐに使用可能。追加のランタイムは不要です。

プロジェクト情報
ライセンスMIT
最終更新2026-06-25 23:45:20
GitHub リポジトリ公式サイト

問題が発生?以下のFAQを確認

2 FAQs

類似プロジェクト