自定义 Spotify API Client 完整配置步骤
前置条件
- Spotify Premium 订阅（硬要求）
- Lyricify 4 v4.3.48 或更高版本（低于此版本不支持自定义 Client，且低于 4.3.48 的版本因 Spotify API 变更已无法正常工作）
准备步骤：在 Spotify Developer Dashboard 创建应用
- 浏览器登录 Spotify 账号
- 打开 Spotify Developer Dashboard（developer.spotify.com/dashboard）
- 第一次打开需要同意 Spotify Developer Terms → 勾选同意 → Accept
- 点 "Create app"
- 填写以下信息：
| 字段 | 填写内容 |
|---|---|
| App name | Lyricify |
| App description | Lyricify Custom API Client |
| Website | （留空） |
| Redirect URI（必须逐条添加） | http://127.0.0.1:766/callback 和 lyricify://callback 两条 |
| Which API/SDKs | 勾选 Web API |
| 同意条款 | 勾选 |
⚠️ Redirect URI 注意事项（踩坑高发点，详见下一页）：
- 第一条必须用
127.0.0.1（IPv4 文字）不是localhost——Spotify 2025 年起拒绝 localhost - 两条 URI 一条是 http、一条是 lyricify://，都必须添加
- 点每条 URI 旁边的 Add 按钮逐条添加，不能一次性贴两个
- 点 Save → 进入应用详情页
- 记录好 Client ID（页面顶部），以及点 "View client secret" 后的 Client Secret
Lyricify 上的工作
- 在 Lyricify 里先退出当前 Spotify 登录（菜单 → 用户组件 → 登出）
- 回到欢迎界面，点左下角「配置自定义 API Client」
- 弹出的窗口里填入刚才拿到的 Client ID 和 Client Secret
- 点确定 → 按正常流程完成 Spotify 授权
- 授权页面的 Redirect URI 自动识别
127.0.0.1:766/callback或lyricify://callback，其中lyricify://callback是 Lyricify 的深层链接协议，让 OAuth 回调自动回到应用
配置成功的验证
回到 Lyricify 主界面，主菜单 → 设置 → 如果看到「自定义 API Client 已启用」字样就是成功了。之后 429 错误频率会显著降低甚至消失——因为你走的是独立配额，不再和其他 Lyricify 用户一起排队。
安全提醒
- Client Secret 不要分享给任何人、不要贴到 GitHub issue、不要发到公开论坛
- 万一暴露了，去 Spotify Developer Dashboard 里把这个 Client 删掉，新建一个
- 自定义 Client 绑定的是你这个 Spotify 账号，换账号登录 Lyricify 后需要重新配置
2026 年 3 月的迁移提醒
由于 Spotify 移除了大量旧接口，之前版本的 Lyricify （低于 4.3.48）从 2026 年 3 月 9 日起无法正常工作。已经配置过自定义 API Client 的用户需要在那个日期之前：
- 更新 Lyricify 到最新版本
- 检查 Spotify Developer Dashboard 里原应用的 Redirect URI 是否已经改成
127.0.0.1（替换之前的 localhost）