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
문제 해결
서버가 Spotify tracks API를 요청할 때 403 Forbidden 오류가 발생하는 이유는 무엇인가요?

403 오류는 일반적으로 유효하지 않은 액세스 토큰이나 부족한 스코프로 인한 인증 또는 권한 문제를 나타냅니다. 이 특정 문제는 이후 서버 릴리스에서 해결되었습니다. 사용 가능한 최신 버전으로 업데이트하세요. 업데이트 후에도 오류가 지속되면 Spotify 앱 자격 증명과 필요한 권한을 다시 확인한 후 추가 지원을 위해 새로운 이슈를 제출하세요.

원본 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

유사한 프로젝트