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 이상으로 업그레이드하십시오.
문제 해결서버가 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