Lyricify-App Documentation

File: README.md Copy Chapter

备注

1. Lyricify Lite 支持所有已接入 SMTC 的 app，如 Spotify、Apple Music、Foobar 2000、HyPlayer、LyricEase、QQ 音乐、网易云音乐 UWP、酷狗音乐、Groove Music 等。
2. Lyricify 4、Lyricify 3 可借助 Wine 实现在 Linux 和 macOS 上运行。Lyricify 4 实现过程可能会比较繁琐，需要您耐心尝试。
   对于 Linux 平台： 我们已经在尝试让 Lyricify 通过 Wine 在 Linux 平台上运行，并力求简便和稳定。您可以在 Lyricify on Wine 仓库下载软件包。
   对于 macOS 平台： 在 M 系列芯片的 Mac 上，建议使用 Windows on ARM 虚拟机运行 Lyricify ARM64 版本以获得更好的体验。你也可以使用 Crossover 运行 x64 版本（需使用 Windows 7 环境）。
3. Lyricify Mobile 可作为兼容的 iPadOS 应用在 visionOS 上运行。
4. Lyricify 3 目前支持 Spotify、iTunes、Apple Music、Music Center、QQ 音乐、网易云音乐、YesPlayMusic，建议 Spotify 用户使用 Lyricify 4，不要使用 Lyricify 3。
5. Lyricify 3 已进入 EOL 阶段，即生命周期已结束。不会再发布任何新功能、错误修复或软件更新。

Notes

1. Lyricify Lite supports all apps connected to SMTC, such as Spotify, Apple Music, Foobar 2000, HyPlayer, LyricEase, QQ Music, Netease Cloud Music UWP, Kugou Music, Groove Music, etc.
2. Lyricify 4, Lyricify 3 can run on Linux and macOS via Wine. The installation process of Lyricify 4 may be cumbersome and requires your patience.
   For Linux platforms: We are endeavoring to operate Lyricify via Wine on the Linux platform, striving for consistent reproduction. You may procure the software package from Lyricify on Wine repository.
   For macOS platforms: On Macs with M-series chips, it is recommended to use a Windows on ARM virtual machine to run the Lyricify ARM64 version for a better experience. You can also use Crossover to run x64 version (Windows 7 environment).
3. Lyricify Mobile can run on visionOS as Compatible iPadOS App.
4. Lyricify 3 currently supports Spotify, iTunes, Apple Music, Music Center, QQ Music, Netease Cloud Music, YesPlayMusic, we suggest all Spotify users to use Lyricify 4, instead of Lyricify 3.
5. Lyricify 3 has reached EOL, which means it has reached the end of life. No new features, bug fixes, or updates will be released.
6. User guide documents are in Simplified Chinese, use a translator if you don't speak Chinese.

Telegram Group / Telegram 群:
https://t.me/lyricify

Telegram Channel / Telegram 频道:
https://t.me/lyricifyreleases

QQ Group / QQ 群:
点击加入群聊【Lyricify 用户群 1】（群号：972282479）（已满）
点击加入群聊【Lyricify 用户群 2】（群号：653663090）（已满）
点击加入群聊【Lyricify 用户群 3】（群号：515098369）（已满）
点击加入群聊【Lyricify 用户群 4】（群号：630964785）（已满）
点击加入群聊【Lyricify 用户群 5】（群号：561373781）（已满）
点击加入群聊【Lyricify 用户群 6】（群号：636998823）（已满）
点击加入群聊【Lyricify 用户群 7】（群号：748154703）（已满）
点击加入群聊【Lyricify 用户群 8】（群号：452502909）（已满）
点击加入群聊【Lyricify 用户群 9】（群号：692205529）（已满）
点击加入群聊【Lyricify 用户群 10】（群号：1060101134）

Lyricify Open Source / Lyricify 开源 Copy Chapter

Lyricify 的歌词处理相关代码均已在 WXRIW/Lyricify-Lyrics-Helper 中使用 Apache License 2.0 协议开源，希望能为开源社区做出贡献。

Lyricify Tools / Lyricify 系列工具 Copy Chapter

Future Plans / 未来计划 (画饼时间) Copy Chapter

Lyricify 系列的未来开发计划。

Lyricify 4 Copy Chapter

More than lyrics 不仅有歌词

A fantastic app to provide auto-scrolling lyrics and additional functions for Spotify.
一款为 Spotify 提供滚动歌词和更多功能的软件。

需要注意的是： Lyricify 4 仅支持 Spotify！

点击这里查看 Lyricify 4 使用指南

Lyricify 4 是免费软件，仅部分个性化设置为商店版独享。如果你觉得 Lyricify 4 做的不错，则可以通过以下渠道支持：

• 在软件中，菜单-关于页里有打赏方式
• 在 Microsoft Store 中购买

如果您在 Microsoft Store 购买过程中遇到困难，可以考虑通过打赏的方式支持 Lyricify。

如果你发现有人在非法销售本软件 (只有 Microsoft Store 中的 Lyricify 是官方发布)，请联系我们！感谢你的支持！

Lyricify 4 Original Copy Section

Lyricify 4 是目前 Lyricify 系列中最具创新的功能结晶，在这里列出部分首创于 Lyricify 的功能。

• 灵动词岛 / Dynamic Lyrics Island *
  • 首创于 2022.09.30
  • 公开于 Lyricify 3.8.1-release
• 妙控条 / Magic Strip *
  • 首创于 2022.10.09
  • 公开于 Lyricify 4.0.0.230121-release
• 歌词界面使用动态专辑封面 / Live Album Cover *
  • 首创于 2022.11.14
  • 公开于 Lyricify 4.0.0.230121-release
• Lyricify Syllable
  • 首创于 2023.03.13
  • 公开于 Lyricify 4.0.8.230315-release
• Lyricify 智能引擎 / Lyricify Intelligent Engine
  • 首创于 2023.04.26
  • 公开于 Lyricify 4.1.0.230503-release

标记 * 的创作采用 CC BY-SA 4.0 协议 进行许可。欢迎转载、使用、重新发布，但务必保留创作署名 Lyricify (及作者 WXRIW 或 XY Wang)，可用于商业目的，基于创意修改后的作品务必以相同的许可发布。如有任何疑问，请与我联系。

Lyricify Lite Copy Chapter

Lyricify Lite 运行于 Windows 平台，仅保留了灵动词岛和桌面歌词功能，支持所有接入了 SMTC 的音乐播放器，包括 HyPlayer、LyricEase、Apple Music、QQ 音乐、网易云音乐 UWP、酷狗音乐、Foobar 2000、Groove Music 等诸多音乐软件。

点击这里查看 Lyricify Lite 使用指南

Lyricify Mobile Copy Chapter

Lyricify Mobile 为 Lyricify 家族的移动端，目前支持 Android，iOS, iPadOS 和 visionOS 平台，且有发布 Windows 版本。在将来版本会提供 macOS 支持。

点击这里查看 Lyricify Mobile 使用指南

注意，Lyricify Mobile 里如果遇到歌词不正确的情况，可以在 Lyricify 4 的歌词管理中进行完善。

Lyricify 3 Copy Chapter

A fantastic app to provide auto-scrolling lyrics for Spotify, iTunes, Apple Music, Music Center, QQ Music, Netease Cloud Music, and YesPlayMusic.
一款为 Spotify、iTunes、Apple Music、Music Center、QQ 音乐、网易云音乐、YesPlayMusic 提供滚动歌词的软件。

点击这里查看 Lyricify 3 使用指南

File: docs/Lyricify Mobile/iOS/IpaGuide.md Copy Chapter

Apple 设备自签教程 By [Tiger](https://github.com/mcuTiger)

前置准备 Copy Chapter

Lyricify Mobile iOS.ipa (在 GitHub Releases 中获得最新版本)、Sideloadly、iTunes、iCloud（iTunes、iCloud 可能需要非 Microsoft Store 版本）

步骤 Copy Chapter

1. 打开 Sideloadly，使用数据线将 iPhone / iPad 连接到您的 PC；点击 IPA 图标，载入 .ipa 文件。

注意事项：
1. 第一次连接时，你的 iPhone / iPad 会提示是否信任此设备，选择信任即可；
2. 连接成功后 iDevice 处会显示您的设备名称。
2. 在 Apple ID 处填写您的 Apple ID 信息；点击 Start 后，填写您的 Apple ID 密码进行验证（登录期间可能会弹出双重验证），签名成功后，程序会将 Lyricify Mobile 安装到你的设备上。

3. 信任开发者 App；

   然后打开您设备的开发者模式，然后重启你的 Apple 设备，并在开机后确认开启开发者模式。

特别注意事项 Copy Chapter

如果在签名过程中报错（卡在步骤 2），请尝试以下方法：

1. 关掉 iTunes，从任务管理器关闭；
2. 进到 C:\ProgramData\Apple Computer\iTunes 文件夹；
3. 将 adi 文件夹更名为 adi.bak 或者直接删掉；
4. 重新打开软件进行签名即可。

其他注意事项 Copy Chapter

此方法只能解锁 7 天；但在 Sideloadly 运行时，将 Apple 设备接上您的 PC 后，App 期限将自动刷新。

隐私提示 Copy Chapter

此教程不保证您的账号安全，如果按照此教程进行 App 自签造成了不可预估的安全后果，则与该教程无关，敏感信息的输入和敏感操作是你自己独立完成的。

File: docs/Lyricify Mobile/CustomClient/Readme.md Copy Chapter

[!CAUTION]

This tutorial has been migrated to [Lyricify Docs](https://docs.lyricify.app/en/lyricify-mobile/custom-api-client/). This legacy page is no longer maintained. Copy Chapter

⚠️ Note:
Clients created after February 11, 2026 will cause Lyricify Mobile to malfunction and become unusable.
Please temporarily do not use newly created custom API Clients and wait for further updates.
For any questions or feedback, please join the Telegram group.

Benefits from customising Spotify API Client Copy Chapter

Spotify API won't affect you by returning 429 Error anymore.

Preparations Copy Chapter

If you have already completed the preparation steps, you can directly use the previously obtained Client ID and Client Secret in Works on Lyricify Mobile part.

1. Login to Spotify (https://www.spotify.com) in your browser, if you have already logged in, go to step 2.

2. Open https://developer.spotify.com/dashboard, if this is your first navigation to this website, you will need to agree with Spotify Developer Terms. Just check I accept the Spotify Developer Terms of Service and click Accept the terms.

3. Click Create app in Dashboard's right top corner.
   If you are prompted with You need to verify your email address before you can create an app., you need to verify your email address first.

4. Fill Create app page with these:

   • App name: Lyricify
   • App description: Lyricify Custom API Client
   • Website: (Leave it empty)
   • Redirect URI:
     • http://127.0.0.1:766/callback
     • lyricify://callback

5. Check Web API in Which API/SDKs are you planning to use? section;
   Check I understand and agree with Spotify's Developer Terms of Service and Design Guidelines;
   Click Save.

6. Now you can see your Client ID，Click View client secret to show the Client secret. Client ID and Client Secret are needed in future steps.

Works on Lyricify Mobile Copy Chapter

1. If you have already logged Spotify in Lyricify Mobile, then you will need to click Cancel button at open.
2. Enter Client ID and Client Secret you previously obtained in welcome page's Custom API Client part.
3. Click Login (Get Token), finish the login and authorization, and you are good to go.

Common Issues

Error during authorization: INVALID_CLIENT: Invalid redirect URI Copy Chapter

Please check if the Redirect URI is entered correctly. Make sure it includes both lyricify://callback and http://127.0.0.1:766/callback, and not https://127.0.0.1:766/callback.
If you're using an Android or iOS device, be sure to include lyricify://callback in the Redirect URI.
Please ensure you are using Lyricify Mobile version 1.5.0 or later and are using redirect to browser login. Due to Spotify's adjustments, embedded web login is temporarily unavailable and will be restored in the next update.

Important Note Copy Section

If you created and configured your custom API Client before April 9, 2025, please make sure to update your app settings in the Spotify Developer Dashboard. Due to recent changes in Spotify's redirect URI validation, URIs using localhost are no longer accepted. You need to replace the original:

http://localhost:766/callback

with:

http://127.0.0.1:766/callback

Go to your app’s settings page, and add http://127.0.0.1:766/callback under the Redirect URIs section. Once updated, your custom API Client should work properly during authorization.

⚠️ Note: 127.0.0.1 is the IP address equivalent of localhost. Under Spotify's current validation rules, 127.0.0.1 is accepted, while localhost is not.

File: docs/Lyricify Mobile/CustomClient/Readme.zh-CN.md Copy Chapter

[!CAUTION]

本教程已迁移至全新 [Lyricify Docs 文档站](https://docs.lyricify.app/lyricify-mobile/custom-api-client/)，本页面不再维护。 Copy Chapter

⚠️ 注意：
2026 年 2 月 11 日之后创建的 Client，会导致 Lyricify Mobile 异常，无法正常使用，请暂时不要使用新创建的自定义 API Client，并等待后续进展。
如有任何问题或反馈可加 QQ 群或 Telegram 群组。

自定义 Spotify API Client 的好处 Copy Chapter

不再会因 Spotify API 返回 429 错误而影响 Lyricify 使用体验。

准备步骤 Copy Chapter

如果你已经完成过准备步骤，则可以直接使用之前获得的 Client ID 和 Client Secret，在 Lyricify Mobile 上的工作 中使用。

1. 在浏览器中登录 Spotify (https://www.spotify.com) ，如果你已登录，可进入步骤 2。

2. 打开 https://developer.spotify.com/dashboard ，如果你是第一次打开这个网址，则需要先同意 Spotify Developer Terms。勾选下方的 I accept the Spotify Developer Terms of Service，再点击 Accept the terms 即可。

3. 点击 Dashboard 页面右上方的 Create app。
   如果提示 You need to verify your email address before you can create an app.，则需要你先验证你的邮箱。

4. 在 Create app 页面中填写以下信息：

   • App name: Lyricify
   • App description: Lyricify Custom API Client
   • Website: （空着不写）
   • Redirect URI: （填写以下两条，每条填写完成后点击 Add 按钮）
     • http://127.0.0.1:766/callback
     • lyricify://callback

5. 勾选 Which API/SDKs are you planning to use? 部分中的 Web API；
   勾选 I understand and agree with Spotify's Developer Terms of Service and Design Guidelines；
   点击 Save 按钮。

6. 这时你就能看到 Client ID，点击 View client secret，即可显示 Client secret。在后续步骤中将需要用到 Client ID 和 Client Secret。

Lyricify Mobile 上的工作 Copy Chapter

1. 如果你已经在 Lyricify Mobile 中登录了 Spotify，则需要在打开 Lyricify Mobile 后，进入登录界面时点击 取消。
2. 在欢迎界面 自定义 API Client 区域对应处输入准备步骤中获取到的 Client ID 和 Client Secret。
3. 点击 登录 (获取 Token)，重新完成登录和授权即可。

常见问题

授权时提示 INVALID_CLIENT: Invalid redirect URI Copy Chapter

请检查 Redirect URI 是否填写错误，确保其值包含 lyricify://callback 和 http://127.0.0.1:766/callback，而不是 https://127.0.0.1:766/callback。
如果你是在 Android 或 iOS 设备上使用，请确保其值包含 lyricify://callback。
请确保你使用的是 1.5.0 或更新版本的 Lyricify Mobile，且使用的是 跳转浏览器登录。由于 Spotify 的调整，内嵌网页登录 暂时无法使用，下一版本更新后将恢复。

特别注意 Copy Section

如果你在 2025 年 4 月 9 日前创建并配置过自定义 API Client，请务必前往 Spotify Developer Dashboard 更新设置。由于 Spotify 调整了对重定向 URI 的要求，原本使用 localhost 的 URI 已不再被接受，你需要将原先的：

http://localhost:766/callback

替换为：

http://127.0.0.1:766/callback

请进入对应应用的设置页面，并在 Redirect URI 中添加 http://127.0.0.1:766/callback。完成后即可正常使用自定义 API Client 进行授权。

⚠️ 注意：127.0.0.1 是 localhost 的等效 IP 地址，在当前 Spotify 的校验机制中被视为有效地址，而 localhost 会被拒绝。

File: docs/Lyricify Mobile/README.md Copy Chapter

[!CAUTION]

Lyricify Mobile 使用指南已迁移至 [docs.lyricify.app/lyricify-mobile](https://docs.lyricify.app/lyricify-mobile/)，旧版使用指南（本页面）不再维护。 Copy Chapter

Lyricify Mobile User Guide has been migrated to [docs.lyricify.app/en/lyricify-mobile](https://docs.lyricify.app/en/lyricify-mobile/). This legacy page is no longer maintained. Copy Chapter

安装问题

如何在 Android 设备上安装 Lyricify Mobile Copy Chapter

下载 .apk 安装包，打开后点击安装即可。

如何在 iPhone 或 iPad 上安装 Lyricify Mobile Copy Chapter

目前 Lyricify Mobile 并未上架 App Store，原因详见这里。
您可以在下载 .ipa 安装包后，采用自签的方式安装，点击这里查看详细教程。

如何在 Mac 上安装 Lyricify Mobile Copy Chapter

直接下载 macOS.pkg 安装即可。（推荐）
您也可以下载 .macOS.zip，将压缩包中的 Lyricify Mobile for macOS.app 拖入 应用程序 文件夹，即可完成安装。
特别的，在 Mac 设备上完成登录需参考本教程。

如何在 Windows 上使用 Lyricify Mobile Copy Chapter

Lyricify Mobile for Windows 为测试性质，不建议日常使用，建议使用具有完整功能的 Lyricify 4。
Lyricify Mobile for Windows 下载 .Windows.zip 后，解压后运行 Lyricify Mobile.WPF.exe 即可。
不支持网页登录，需要手动输入 Token。类似的，可参考本教程。

常见问题

无法登录 Copy Chapter

红框提示：糟糕！出了点问题。

导致原因 Copy Section

网络问题。

解决方案 Copy Section

科学上网。

登录时提示 INVALID_CLIENT: Invalid Redirect URI Copy Chapter

检查你的 Redirect URI 是否正确填写。确保教程中的两条 Redirect URI 均已正确填写。
请确保你使用的是 1.5.0 或更新版本的 Lyricify Mobile，且使用的是 跳转浏览器登录。由于 Spotify 的调整，内嵌网页登录 仅在 1.5.1 或更新版本的 Lyricify Mobile 上支持。

在 Mac 设备上完成登录 Copy Chapter

Lyricify Mobile for macOS 仅支持 内嵌网页登录，如果你在直接登录的过程中遇到问题，可尝试借助其他平台的设备辅助完成登录。
目前可借助其他平台的设备通过以下方法完成授权。

借助 Windows 设备 Copy Section

你可以借助 Windows 设备完成 Lyricify Mobile for macOS 的登录授权。具体步骤如下。

1. 在 Windows 设备上安装 Lyricify 4 并完成登录授权。
2. 打开 Lyricify 4 主菜单 (左上角 ···)，找到 高级，点击 复制 Refresh Token。
3. 此时授权信息已复制到你的 Windows 剪切板中，你可以通过其他软件将此信息传递到你的 Mac 设备。
4. 在 Mac 设备上打开 Lyricify Mobile for macOS，点击左上角 返回 按钮，这时你能看到 3 个文本框，请在第 3 个 (Spotify Refresh Token) 中粘贴授权信息。
5. 点击 继续 按钮，即可完成登录授权。

借助 iPhone、iPad 或 Android 设备 Copy Section

你可以借助 iPhone、iPad 或 Android 设备完成 Lyricify Mobile for macOS 的登录授权。具体步骤如下。

1. 在 iPhone、iPad 或 Android 设备上安装 Lyricify Mobile 并完成登录授权后，关闭 Lyricify Mobile。
2. 打开 Lyricify Mobile，出现 登录中 页面时，点击下方的 取消 按钮，此时你能看到 3 个文本框。
3. 在 Mac 设备上打开 Lyricify Mobile for macOS，点击左上角 返回 按钮，这时你能看到相同的 3 个文本框。
4. 将 iPhone、iPad 或 Android 设备上文本框中的内容一一对应地复制到 Mac 设备上。
5. 点击 继续 按钮，即可完成登录授权。

无法正常进入歌词界面 Copy Chapter

提示 connection closed: 检查你的网络
提示 invalid_grant: 重新登录

切歌后反应迟钝 Copy Chapter

切歌后 Lyricify 需要过较长时间才能显示新的歌曲信息。
见下方 总是提示出现 429 错误

总是提示出现 429 错误 Copy Chapter

进行操作时总是提示出现 429 错误。

导致原因 Copy Section

Spotify 返回了 429 请求过多 错误，不是 Lyricify 的锅。

解决方案 Copy Section

配置自定义 API Client，可参考这个教程。
或者等待，等到 Spotify 不返回 429 了，就好了。

超长 429 错误 Copy Chapter

配置了自定义 API Client 并使用了一段时间后，提示出现了等待时长达到几千或几万秒的 429 错误。

导致原因 Copy Section

连续使用时长过长。连续使用十几个小时，或在没有播放歌曲时使用 Lyricify 达几个小时，都有几率出现超长 429 错误。

解决方案 Copy Section

• 创建一个新的 Client，然后重新在 Lyricify 中登录和授权。
• 您还可以等待，直至 429 错误结束。

一些建议 Copy Section

1. 尽量避免连续使用过长时间 (10 小时以上)，这会导致单位时间内的请求量超过 Spotify API 阈值，这就会让出现超长 429 错误的概率增大很多。
2. 如果您在多台设备上使用 Lyricify，且使用频率高，则可以为每台设备单独创建一个 Client，这样可以分散请求，防止触发阈值限制。
3. 在没有播放歌曲时，请关闭 Lyricify。在这种情况下保持 Lyricify 的运行，几个小时 (最短 1-3 小时) 就会导致 429 错误。（Android 设备上不使用 Lyricify 时，请关闭其后台，若不关闭，则会连续发送请求，造成超长 429 错误。iOS 设备及部分 Android 设备上可以不关闭后台）

Lyricify 无法获取当前播放信息 Copy Chapter

Lyricify 没有显示当前正在播放的歌曲。

导致原因 Copy Section

Spotify 没有上传当前的播放信息。这是网络原因，也可能是 Spotify 客户端的问题。

解决方案 Copy Section

1. 尝试重启 Spotify 客户端。
2. 校园网用户，可以尝试使用热点。
3. 如在使用科学上网工具，可尝试更换节点、调整分流、更换服务提供商等。
4. 重装 Spotify 最新版。
5. 使用 Spotify 网页版。
6. Spotify 的播放信息是由 Spotify 提供的，不是 Lyricify 的锅，自己想办法解决。

如何导入歌词 Copy Chapter

提示 “没有找到歌词，您可以在 Lyricify 4 中导入歌词”

解决方案 Copy Section

在 Lyricify 4 中自行导入即可。
注：Lyricify 4 是电脑软件。
具体操作方法

提示没有找到歌词 Copy Chapter

没搜到歌词。
提示 “没有找到歌词，您可以在 Lyricify 4 中导入歌词”

导致原因 Copy Section

确实没搜到歌词。

解决方案 Copy Section

在 Lyricify 4 中自行导入即可。
注：Lyricify 4 是电脑软件。
具体操作方法

电脑上有歌词，手机上没有/错误 Copy Chapter

解决方案 Copy Section

在 Lyricify 4 中标记歌词后重新打开 Lyricify Mobile 即可。

歌词没有翻译 Copy Chapter

歌词对的啊，为啥没翻译啊。

导致原因 Copy Section

搜到的这个歌词就是没翻译的，反正不是 Lyricify 的锅。

解决方案 Copy Section

在 Lyricify 4 中自行导入有翻译的版本即可。

没有逐字歌词 Copy Chapter

为啥不显示逐字歌词呢？

导致原因 Copy Section

Lyricify Mobile 不支持逐字歌词的显示。也没有加入此功能的计划。

解决方案 Copy Section

自行脑补逐字歌词。或使用 Lyricify 4。

如何使用其他界面 Copy Chapter

我只找到了 Apple Music 界面，没找到其他界面哎。

导致原因 Copy Section

Lyricify Mobile 只有这个界面。

解决方案 Copy Section

在 Windows 设备上使用 Lyricify 4。

如何使用桌面歌词 Copy Chapter

Lyricify Mobile 不支持桌面歌词。

导致原因 Copy Section

由于 Lyricify Mobile 是跨平台开发的，需要同时考虑 Android 和 iOS，而 iOS 上无法实现传统桌面歌词效果，故 Android 上也暂时不会添加桌面歌词功能。

解决方案 Copy Section

在 Android 上可使用小窗等功能来近似实现。
在 Windows 上可使用 Lyricify 4 获取完整体验。
在 iOS、iPadOS、macOS 上暂无解决方案。

非 Android 设备上没有模糊效果 Copy Chapter

在 iOS 等设备及部分 Android 设备上没有模糊效果。

导致原因 & 解决方案 Copy Section

iOS 的 UIKit 没有提供可指定半径的模糊接口，故无法实现此效果。需等待 Lyricify Mobile 2。
Android 旧版本没有提供模糊 API，可升级至 Android 12 或更高版本以实现本效果。

如何在手机上使用 Lyricify 4 Copy Chapter

Lyricify 4 好多功能 Lyricify Mobile 都没有啊，啥时候才能有呢。

导致原因 Copy Section

Lyricify Mobile 目标就是显示歌词，现在目标已经达成。

解决方案 Copy Section

在 Windows 设备上使用 Lyricify 4。您可以给您的手机安装 Windows on ARM。

歌词比歌曲快或慢 Copy Chapter

Lyricify Mobile 中显示的歌词比歌曲快了或者慢了。

导致原因 Copy Section

Spotify API 提供的播放进度不准，这是由多个原因导致的。

1. Spotify 客户端向 Spotify 服务器发送进度有误差或延迟。
2. Lyricify Mobile 向 Spotify 服务器发送进度请求有误差或延迟。
3. Spotify 本身进度不准。
   由一系列原因，造成歌词显示时间轴不准确。

解决方案 Copy Section

±2s 内的延迟属于正常范围。
如果您无法接受这个延迟，则建议在 Windows 设备上使用 Lyricify 4。

iOS 版是否会上架 App Store Copy Chapter

使用自签方式安装非常麻烦，而上架 App Store 后则会方便很多，为什么不上架呢？

导致原因 Copy Section

1. Apple 要求上传 App Store 需要 Apple 开发者账号，年费 688 元，十分高昂。
2. 若需在 App Store 大陆地区上架，还需进行 ICP 备案，导致通过审核的几率更低。若仅上架外区，大部分大陆用户没有相关支付方式，也将成为一个问题。

解决方案 Copy Section

自签安装即可。
或等待 Lyricify Mobile 2 的到来。Lyricify Mobile 2 将专为 Apple 平台开发，在完成开发后会在 App Store 上架，预计最快一至两年后会开始开发，敬请期待。

File: docs/Lyricify Lite/README.md Copy Chapter

[!CAUTION]

Lyricify Lite 使用指南已迁移至 [docs.lyricify.app/lyricify-lite](https://docs.lyricify.app/lyricify-lite/)，旧版使用指南（本页面）不再维护。 Copy Chapter

Lyricify Lite User Guide has been migrated to [docs.lyricify.app/en/lyricify-lite](https://docs.lyricify.app/en/lyricify-lite/). This legacy page is no longer maintained. Copy Chapter

App 支持列表

已知支持 Lyricify Lite 的 app 如下表所示。

注意：

1. 请确保相关 app 已更新至最新版本，部分旧版本可能并不支持 SMTC。Spotify 用户建议使用 Lyricify 4，不建议使用 Lyricify Lite，点击查看具体原因。
2. 对于 SMTC 无时间轴信息的 app，Lyricify Lite 将使用内置定时器更新歌词进度，所以在手动修改播放进度后，Lyricify Lite 无法更新播放进度，歌词会发生前后错位。
3. 曲目匹配“完美”指 Lyricify Lite 可以完美匹配当前播放的曲目。其它匹配程度指 Lyricify Lite 需要通过对曲目信息进行搜索来匹配对应曲目，所以匹配可能不精准或匹配不到。
4. 所有接入 SMTC 的应用均支持 Lyricify Lite，未在上表中列出的 app 并不代表不支持 Lyricify Lite。
5. Apple Music 的时间轴传递不稳定，借助 Lyricify 智能引擎，Lyricify Lite 在 Microsoft Store 商店购买版中添加了“Apple Music 时间轴稳定器”功能，且默认开启。具体可参考常见问题。

Lyricify Lite 基础

Lyricify Lite 是什么 Copy Chapter

Lyricify Lite 是 Lyricify 家族于 2024 年 12 月推出的新软件，它运行于 Windows 平台，仅保留了 Lyricify 4 的灵动词岛功能（并已在后期加入桌面歌词等功能），支持所有接入了 SMTC 的音乐播放器，包括 HyPlayer、LyricEase、Apple Music、QQ 音乐、网易云音乐 UWP、酷狗音乐、Foobar 2000、Groove Music 等诸多音乐软件。

Lyricify Lite 有哪些功能 Copy Chapter

Lyricify Lite 目前有灵动词岛和桌面歌词功能，支持所有接入了 SMTC 的音乐播放器，支持单独调节设备延迟、app 延迟、歌词显示等设置。

运行 Lyricify Lite Copy Chapter

如果您想使用 Lyricify Lite，请确保您的系统版本不低于 10.0.17763.0，且安装了 .NET Desktop Runtime 8.0。如果启动时提示您的未安装，则需要您在这里下载安装：
点击下载 .NET Desktop Runtime 8.0.11 x86 x64 Arm64
点击转到 .NET 8.0 官方下载地址

如何找到运行中的 Lyricify Lite Copy Chapter

你随时可以在系统通知栏（托盘）中找到 Lyricify Lite 的图标。
你可以右击该图标以控制 Lyricify Lite，包括开启功能、配置设置、退出 Lyricify Lite 等。

常见问题

注意： 如需反馈或提问，对于 Lyricify 功能，请使用官方认定的正确的名称来描述。

Microsoft Store 版本与 GitHub 版本有什么区别 Copy Chapter

注：下文中的 GitHub 版本指 Microsoft Store 版本外的其他分发方式分发的版本，含群聊、网盘等分发渠道。

主要区别 Copy Section

1. 发布新版本时，Microsoft Store 版本通常会提前 1-3 天更新，您可以提前体验新功能。
2. Microsoft Store 版本的自动更新由 Microsoft 负责和管理，体验更好。
   GitHub 版本的更新由 Lyricify 负责，更新源为 GitHub 服务器，在部分地区体验不如 Microsoft Store 版本。
3. 部分功能为 Microsoft Store 版本独享功能。

Microsoft Store 独享功能 Copy Section

为了提升用户体验，促进开发良性循环，部分功能是作为 Microsoft Store 独享功能开发的。
目前 Microsoft Store 版本有以下独享功能：

1. 灵动词岛的自定义字体功能。
2. 桌面歌词的自定义字体功能。
3. 任务栏歌词的自定义字体功能。
4. 独享中国大陆加速服务器。
5. 其他歌词界面的自定义字体功能。

在 Microsoft Store 购买 Lyricify 是对 Lyricify 开发者的一种支持和信任，感谢所有购买或打赏过 Lyricify 的用户！也欢迎各位用户给出 5 星好评和评语，这对我有很大帮助！

更多信息 Copy Section

Lyricify Lite 是免费软件，仅部分个性化设置为商店版独享。如果你觉得 Lyricify Lite 做的不错，则可以通过以下渠道支持：

• 在软件中，菜单-关于页里有打赏方式
• 在 Microsoft Store 中购买

如果您在 Microsoft Store 购买过程中遇到困难，可以考虑通过打赏的方式支持 Lyricify。

如果你发现有人在非法销售本软件 (只有 Microsoft Store 中的 Lyricify 是官方发布)，请联系我们！感谢你的支持！

Self-contained 版本特殊说明 Copy Chapter

Self-contained 版本包含 .NET 8.0 Desktop Runtime 运行时，仅建议那些因某些原因无法正常安装 .NET 8.0 运行时的用户使用。其他用户建议选择 Microsoft Store 版本或标准安装版（即不包含 .NET 运行时的版本）。
请注意：Self-contained 版本不支持自动更新。在发布新版本后，用户需要手动下载并安装更新。Lyricify 默认开启自动更新，尽管 self-contained 版本仍会尝试下载并安装更新，但由于更新内容为标准版本，即不包含 .NET 运行时，更新后 Lyricify 应用将无法启动。

无法检测到播放器 Copy Chapter

Lyricify Lite 无法检测到你正在使用的音乐软件的播放状态。

导致原因 Copy Section

你使用的软件可能并不支持 SMTC，或是没有正确配置 SMTC。

解决方案 Copy Section

如果你使用的软件在 App 支持列表 中列出，请查看逐应用常见问题。

Microsoft Store 版创建快捷方式 Copy Chapter

1. 打开 开始菜单，点击右上角的 所有应用。
2. 找到 Lyricify Lite，按住拖动到想要创建快捷方式的地方即可完成创建。

桌面歌词 或 灵动词岛 异常消失 Copy Chapter

打开 桌面歌词 或 灵动词岛 后，闪一下就消失了，或是在最小化所有窗口后消失。

导致原因 Copy Section

有全屏窗口处于前台。

解决方案 Copy Section

想办法关闭该全屏窗口 (如动态壁纸等)，或在设置中关闭 全屏隐藏 选项。

桌面歌词如何调整字号 Copy Chapter

纵向调整桌面歌词大小即可调整字号。

使用 OBS 捕获桌面歌词 Copy Chapter

因为这个功能的特殊性，所以没有在 设置 页面中提供修改选项，目前需要手动修改配置文件。
打开 设置，找到 高级 设置文件 打开，然后找到 enable_obs_capture 属性 (在 187 行附近)，将 false 修改为 true 后保存文件，然后点击 加载 即可。

自定义字体 Copy Chapter

Lyricify Lite 有着强大的自定义字体功能，您可以为 灵动词岛 和 桌面歌词 设置自定义字体。
如果您想要自定义字体，则可以通过以下步骤实现：

1. 设置中找到对应界面的 字体家族 设置，点击 自定义 按钮。
2. 这时会打开 字体选择工具 窗口，左侧为已安装字体列表，右侧为自定义字体列表。
3. 在左侧找到你想设置的字体，选中后点击 添加到列表 或直接双击该字体，即可添加至右侧自定义字体列表。
4. 点击确定即可保存。在保存之前，您可以在 预览 文本框中测试自定义字体效果。
5. 如果您想为中西文设置不同字体，可以自行了解 字体回退机制，Lyricify Lite 自带的 字体选择工具 支持 字体回退 (Font Fallback)。

如果您想使用某字体的加粗版本，您可以这样设置：

1. 首先在 字体选择工具 中设置好字体（步骤在上方）。
2. 点击 设置 窗口 高级 页 设置文件 的 打开 按钮。
3. 在打开的文件中找到对应的字体配置。
   • 桌面歌词: desktop_lyrics font_family
4. 修改字体名，在字体名后加上 Bold，如 Microsoft YaHei 修改后为 Microsoft YaHei Bold。

注意：

1. 并非所有字体都支持这种修改为加粗版本的方式。
2. 如果有不理解的地方，您可以自行搜索和学习 JSON 文件 的相关知识。

自动更新 Copy Chapter

Lyricify Lite 支持自动更新，其策略如下。

Microsoft Store 版本 Copy Section

Microsoft Store 版本的自动更新由 Microsoft 负责。
Lyricify Lite 的默认策略是在启动时自动检查更新，有更新时会请求 Microsoft Store 进行静默更新，并在用户关闭 Lyricify Lite 或重启后完成更新。
你可以在 Lyricify Lite 的设置中修改该策略。

非 Microsoft Store 版本 (GitHub 版本) Copy Section

非 Microsoft Store 版本的自动更新由 Lyricify Lite 负责。
Lyricify Lite 会在启动时自动检查更新，有更新时会立即下载更新并完成安装，更新过程会自动重启 Lyricify Lite。
Lyricify Lite 默认开启自动更新，你可以在设置中修改该策略以停用普通更新。需要注意的是，版本过低时的强制更新不受该设置影响。

配置文件迁移 Copy Chapter

如果你原先在另一台设备上使用 Lyricify Lite，现在想要将配置文件迁移至新的设备，则可通过以下方法实现。

从源设备上获取配置文件 Copy Section

如果你使用的是非商店版（即普通安装版或绿色版），或是在使用商店版之前曾在这台设备上使用过非商店版，则可以在以下路径中找到 Lyricify Lite 的配置文件：

%AppData%\Lyricify\Lyricify Lite

如果你一直使用的是商店版，则可以在以下路径中找到 Lyricify Lite 的配置文件：

%LocalAppData%\Packages\63265WXRIW.193470E81A0DE_8ybqz4qm5hwha\LocalCache\Roaming\Lyricify\Lyricify Lite

如果你使用的是便携版，则可以在以下路径中找到 Lyricify Lite 的配置文件：

\Data

将文件复制到目标设备 Copy Section

如果你想在目标设备上使用非商店版，你可以直接将配置文件复制到以下路径：

%AppData%\Lyricify\Lyricify Lite

如果你想在目标设备上使用商店版，且在复制前没有在目标设备上运行过 Lyricify Lite 商店版，则可以将配置文件复制到上方路径。你也可以将配置文件复制到以下路径（如果在复制前曾运行过 Lyricify Lite 商店版，则必须将配置文件复制到以下路径）：

%LocalAppData%\Packages\63265WXRIW.193470E81A0DE_8ybqz4qm5hwha\LocalCache\Roaming\Lyricify\Lyricify Lite

应当复制哪些文件 Copy Section

条件允许的情况下，建议复制配置文件路径下的全部文件及文件夹至目标设备路径。
如果你想在迁移配置文件的同时，丢弃日志文件及缓存文件，则可以仅复制以下文件或文件夹：

Settings.json   // 设置文件

常见问题（逐应用）

Spotify 用户应使用 Lyricify 4 Copy Chapter

对于 Spotify 用户，我们推荐使用 Lyricify 4，而不建议使用 Lyricify Lite。

具体原因 Copy Section

1. Lyricify 4 全称 Lyricify for Spotify，是专为 Spotify 研发的软件，针对 Spotify 提供了专门的优化，提升用户体验。
2. Lyricify 4 提供独立的词库，用户可以标记或上传准确的歌词，并对错误歌词进行修正。与之相比，Lyricify Lite 当前尚未接入 Lyricify 4 的词库，使用时体验较差。
3. Lyricify 4 不仅拥有更丰富的歌词展示界面，还包含诸如针对 Spotify 优化的全局快捷键、曲库查询、时间轴优化等更多实用功能。

更多信息 Copy Section

如果你仅使用 Lyricify Lite 的灵动词岛或桌面歌词功能配合 Spotify，仍然建议切换到 Lyricify 4。尽管它们在表面功能上相似，但在实际体验上，Lyricify 4 将为你提供更好的词库与功能支持。

使用 QQ 音乐时没有时间轴 Copy Chapter

在使用 QQ 音乐时，手动修改播放进度后，Lyricify Lite 无法更新播放进度，歌词发生前后错位。

导致原因 Copy Section

没有更新至支持 SMTC 时间轴的 QQ 音乐版本。

解决方案 Copy Section

更新 QQ 音乐至最新版，确保其版本号不低于 21.10.2962。

无法检测到 QQ 音乐 Copy Chapter

导致原因 Copy Section

QQ 音乐不是最新版，或未开启 SMTC。

解决方案 Copy Section

更新 QQ 音乐至最新版，并确保 SMTC 已启用（位置：设置->常规设置->通知->显示系统媒体传输控件（SMTC））。

无法检测到网易云音乐 Copy Chapter

导致原因 Copy Section

网易云音乐 Win32 原版并不支持 SMTC。

解决方案 Copy Section

安装由 apoint123 重构的 InfLink 插件即可。

使用网易云音乐时时间轴异常 Copy Chapter

在使用网易云音乐时，Lyricify Lite 歌词卡在曲目信息或第一句歌词，无法正常显示。

导致原因 Copy Section

InfinityLink 插件异常的传递了时间轴信息，导致 Lyricify Lite 获取到的 SMTC 信息错误，故产生异常行为。

解决方案（新） Copy Section

安装由 apoint123 重构的 InfLink 插件。

解决方案（旧） Copy Section

联系 InfinityLink 插件作者进行反馈，等待修复，暂时更换其它播放器，或等待网易云官方支持 SMTC。
你也可以尝试开启 设置->逐应用配置->网易云音乐->修改->使用内置计时器，以屏蔽时间轴信息。

无法检测到酷狗音乐 Copy Chapter

导致原因 Copy Section

酷狗音乐不是最新版，或未开启 SMTC。

解决方案 Copy Section

更新酷狗音乐至最新版，并确保 SMTC 已启用（位置：设置->常规设置->播放->支持系统播放控件，如锁屏界面）。

无法检测到 PotPlayer Copy Chapter

导致原因 Copy Section

PotPlayer 不是最新版，没有 SMTC 功能。

解决方案 Copy Section

更新 PotPlayer 至最新版，最低版本要求 240618。

Apple Music 时间轴不稳定 Copy Chapter

使用 Apple Music 时，时间轴不稳定，存在异常跳动现象。

导致原因 Copy Section

Apple Music 提供的时间轴精度很低，且上报不稳定。
这个问题自 Apple Music Windows 发布以来就已存在，Lyricify Lite 已尽力优化。

解决方案（新） Copy Section

你可以尝试使用 Lyricify 智能引擎提供的全新方案：Apple Music 时间轴稳定器。

注意：

1. 本功能仅 Microsoft Store 商店购买版支持，且默认开启。
2. 设置项位置：设置 -> 逐应用配置 -> Apple Music -> 修改 -> Apple Music 时间轴稳定器。
3. 开启本功能后，Lyricify 将自动优化和调整 Apple Music 传入的时间轴，尽力提供一个稳定的进度输出。
4. 由于 Apple Music 存在延迟，建议将会话延迟调整为 -500 ms ~ -400 ms。

解决方案（旧） Copy Section

与 Apple 取得联系，并向他们寻求帮助。或更换其他音乐 app，以提升你的 Lyricify 使用体验。

附录

Lyricify 名词 Copy Chapter

请规范使用 Lyricify 正确的名称或专有名词来描述反馈、提问。自行造词会带来很多麻烦和困惑。

功能 Copy Section

灵动词岛 Copy Section

其它 Copy Section

File: docs/Lyricify 4/LyricifyAccount/README.md Copy Chapter

Lyricify Account

The Lyricify account is the necessary credential for you to get, mark, and upload lyrics. Only when you have a Lyricify account and the status is normal, you can perform server operations such as uploading lyrics.

Lyricify account registration Copy Chapter

Your Lyricify account is linked to the Spotify account you log into on Lyricify. When you log into your Spotify account on Lyrcify for the first time, Lyricify will automatically register the associated Lyricify account.
After you complete the Spotify account authorization, if Lyricify prompts You are No. n Lyricify user, it means that your Spotify account has been successfully registered and associated on the Lyricify server. Can be used normally.
If after completing the Spotify account authorization, Lyricify prompts Failed to register on Lyricify server. Server side functions might be limited. A re-login might solve this issue. which indicates that Lyricify account registration failed, or this link failed. If you have not used Lyricify 4 before, or have used it before, but it does not display You are No. n Lyricify user, it means that the Lyricify account registration failed. You can try the following:

1. If you are using a proxy, you can close it and try again.
2. Change the network environment and ensure that api.lyricify.app can be accessed. You can test it by accessing https://api.lyricify.app/app/connection-test. If OK is returned, the connection is normal.

Note: The try again mentioned above refers to logging out of Lyricify and re-authorizing the login.

Lyricify account is restricted Copy Chapter

Lyricify accounts that violate Lyricify Lyrics Vault regulations will be restricted when reported by users or discovered by Lyricify managers.
If your Lyricify account has been restricted, don't panic; you can request to have the restriction removed by contacting a member of the Lyricify admin team. We will tell you the reasons and specific tracks that led to the restriction. We will unblock your account after you relearn the Lyricify Lyrics Vault rules.
For specific rules of Lyricify Lyrics Vault, please click here to view. (the documents are in Simplified Chinese, use a translator if needed)

How to contact Lyricify to remove restrictions Copy Section

• Via Telegram Group
• Via GitHub Issues (not recommended)
• Via Email. Please use Lyricify Account Unrestriction as the email subject

General limitations of Lyricify accounts Copy Chapter

In order to protect the Lyricify Lyrics Vault and server, Lyricify accounts only have permission to access the Lyricify Lyrics Vault within 24 hours after completing the registration, but do not have the permission to upload lyrics to the Lyricify Lyrics Vault. If it prompts Your upload request has been denied and the account registration time is within 24 hours, you need to wait patiently.
If you encounter Part of the upload has failed, please try again later when uploading, it means that you have uploaded too many times in a short period of time. It is recommended to wait 2-3 hours and try again.

File: docs/Lyricify 4/LyricifyAccount/README.zh-CN.md Copy Chapter

Lyricify 账户

Lyricify 账户是您获取、标记、上传歌词时的必要凭证。只有当您有 Lyricify 账户，且状态正常时，才可以进行上传歌词等服务器操作。

注册 Lyricify 账户 Copy Chapter

Lyricify 账户与您在 Lyricify 上登录的 Spotify 账号相关联。您首次在 Lyrcify 上登录 Spotify 账号时，Lyricify 会自动注册关联的 Lyricify 账户。
在您完成 Spotify 账号授权后，若提示 你是第 n 位 Lyricify 用户 则说明您的 Spotify 账号已成功在 Lyricify 服务器上完成注册和关联。可正常使用。
若在完成 Spotify 账号授权后提示 在 Lyricify 服务器上注册失败。服务器端的功能可能会被限制。重新登录可能会解决此问题，这说明 Lyricify 账户注册失败，或本次关联失败。若您在之前没有使用过 Lyricify 4，或之前使用过，但没有显示 你是第 n 位 Lyricify 用户，则说明 Lyricify 账户注册失败。您可以尝试以下方式：

1. 如果您在使用代理，可关闭后再试。
2. 如果您在使用代理，可调整分流后再试。Lyricify 的主服务器在境外，域名为 api.lyricify.app。
3. 更换网络环境，确保可以访问 api.lyricify.app，您可以通过访问 https://api.lyricify.app/app/connection-test 来测试，返回 OK 说明连接正常。

注意：以上所说的重试指的是关闭 Lyricify 并重新打开。你也可以尝试在 Lyricify 上登出，并重新授权登录。

Lyricify 账户被限制 Copy Chapter

对于违反 Lyricify 歌词库规定的 Lyricify 账户，当用户发现举报或由管理组成员发现后，将做限制处理。
如果您的 Lyricify 账户被限制了，不要慌张，与 Lyricify 管理组成员取得联系后即可申请解除限制。我们会告诉您导致被限制的原因和具体曲目。您在重新学习 Lyricify 歌词库规定后，我们就会解封您的账号。
有关 Lyricify 歌词库的具体规则，可点击此处查看。

如何联系 Lyricify 以解除限制 Copy Section

• 通过 QQ 群组
• 通过 Telegram 群组
• 通过 GitHub Issues 反馈 (不推荐)
• 通过邮件。注意，请以 Lyricify 账户解除限制 为邮件标题

账户的一般限制 Copy Chapter

为了保护 Lyricify 歌词库及服务器，Lyricify 账户在完成注册后的 24 小时内，只有访问 Lyricify 歌词库的权限，并不具有将歌词上传至 Lyricify 歌词库的权限。若提示 你的上传请求被拒绝 且账户注册时间在 24 小时内，则需耐心等待。
如果您在上传时遇到 部分上传失败，请稍后再试，则说明您短时间内上传次数过多，建议等待 2-3 小时后再试。

File: docs/Lyricify 4/CustomClient/Readme.md Copy Chapter

[!CAUTION]

This tutorial has been migrated to [Lyricify Docs](https://docs.lyricify.app/en/lyricify-4/custom-api-client/). This legacy page is no longer maintained. Copy Chapter

⚠️ Note:
Custom API Client requires Lyricify 4 v4.3.48 or later.
Due to Spotify removing a large number of APIs, earlier versions of Lyricify will no longer function properly.
If you have already completed the configuration, please update to v4.3.48 or later before March 9, 2026.
For any questions or feedback, please join the Telegram group.

Benefits from customising Spotify API Client Copy Chapter

Spotify API won't affect you by returning 429 Error anymore.

Requirements Copy Chapter

An active Spotify Premium subscription is required to use the Custom API Client.
Users who previously completed the configuration will also be required to have Spotify Premium starting March 9, 2026, otherwise the Custom API Client will no longer function.

Preparations Copy Chapter

If you have already completed the preparation steps, you can directly use the previously obtained Client ID and Client Secret in Works on Lyricify part.

1. Login to Spotify (https://www.spotify.com) in your browser, if you have already logged in, go to step 2.

2. Open https://developer.spotify.com/dashboard, if this is your first navigation to this website, you will need to agree with Spotify Developer Terms. Just check I accept the Spotify Developer Terms of Service and click Accept the terms.

3. Click Create app in Dashboard's right top corner.
   If you are prompted with You need to verify your email address before you can create an app., you need to verify your email address first.

4. Fill Create app page with these:

   • App name: Lyricify
   • App description: Lyricify Custom API Client
   • Website: (Leave it empty)
   • Redirect URI:
     • http://127.0.0.1:766/callback
     • lyricify://callback

5. Check Web API in Which API/SDKs are you planning to use? section;
   Check I understand and agree with Spotify's Developer Terms of Service and Design Guidelines;
   Click Save.

6. Now you can see your Client ID，Click View client secret to show the Client secret. Client ID and Client Secret are needed in future steps.

Works on Lyricify Copy Chapter

1. If you have already logged Spotify in Lyricify, then you will need to log it out first.

2. Click Configure Custom API Client in welcome page's left bottom corner.

3. Enter Client ID and Client Secret you previously obtained.

4. Continue the login, and just enjoy Lyricify.

Common Issues

Error during authorization: INVALID_CLIENT: Invalid redirect URI Copy Chapter

Please check if the Redirect URI is entered correctly. Make sure it includes http://127.0.0.1:766/callback and not https://127.0.0.1:766/callback.

Important Note Copy Section

If you created and configured your custom API Client before April 9, 2025, please make sure to update your app settings in the Spotify Developer Dashboard. Due to recent changes in Spotify's redirect URI validation, URIs using localhost are no longer accepted. You need to replace the original:

http://localhost:766/callback

with:

http://127.0.0.1:766/callback

Go to your app’s settings page, and add http://127.0.0.1:766/callback under the Redirect URIs section. Once updated, your custom API Client should work properly during authorization.

⚠️ Note: 127.0.0.1 is the IP address equivalent of localhost. Under Spotify's current validation rules, 127.0.0.1 is accepted, while localhost is not.

File: docs/Lyricify 4/CustomClient/Readme.zh-CN.md Copy Chapter

[!CAUTION]

本教程已迁移至全新 [Lyricify Docs 文档站](https://docs.lyricify.app/lyricify-4/custom-api-client/)，本页面不再维护。 Copy Chapter

⚠️ 注意：
自定义 API Client 需使用 Lyricify 4 v4.3.48 或更高版本。
由于 Spotify 移除了大量接口，会导致之前的 Lyricify 版本无法正常工作。
之前已完成配置的用户，需在 2026 年 3 月 9 日前更新到 4.3.48 或更新版本。
如有任何问题或反馈可加 QQ 群或 Telegram 群组。

自定义 Spotify API Client 的好处 Copy Chapter

不再会因 Spotify API 返回 429 错误而影响 Lyricify 使用体验。

要求 Copy Chapter

使用自定义 API Client 需要拥有 Spotify Premium 订阅。
此前已完成配置的用户，自 2026 年 3 月 9 日起，也必须拥有 Spotify Premium 订阅，否则将无法继续使用自定义 API Client。

准备步骤 Copy Chapter

如果你已经完成过准备步骤，则可以直接使用之前获得的 Client ID 和 Client Secret，在 Lyricify 上的工作 中使用。

1. 在浏览器中登录 Spotify (https://www.spotify.com) ，如果你已登录，可进入步骤 2。

2. 打开 https://developer.spotify.com/dashboard ，如果你是第一次打开这个网址，则需要先同意 Spotify Developer Terms。勾选下方的 I accept the Spotify Developer Terms of Service，再点击 Accept the terms 即可。

3. 点击 Dashboard 页面右上方的 Create app。
   如果提示 You need to verify your email address before you can create an app.，则需要你先验证你的邮箱。

4. 在 Create app 页面中填写以下信息：

   • App name: Lyricify
   • App description: Lyricify Custom API Client
   • Website: （空着不写）
   • Redirect URI: （填写以下两条，每条填写完成后点击 Add 按钮）
     • http://127.0.0.1:766/callback
     • lyricify://callback

5. 勾选 Which API/SDKs are you planning to use? 部分中的 Web API；
   勾选 I understand and agree with Spotify's Developer Terms of Service and Design Guidelines；
   点击 Save 按钮。

6. 这时你就能看到 Client ID，点击 View client secret，即可显示 Client secret。在后续步骤中将需要用到 Client ID 和 Client Secret。

Lyricify 上的工作 Copy Chapter

1. 如果你已经在 Lyricify 中登录了 Spotify，则需要先在 Lyricify 中退出登录。

2. 点击欢迎界面左下角的 配置自定义 API Client。

3. 在弹出的窗口中输入准备步骤中获取到的 Client ID 和 Client Secret，点击确定即可。

4. 继续完成登录，享受你的 Lyricify 之旅吧。

常见问题

授权时提示 INVALID_CLIENT: Invalid redirect URI Copy Chapter

请检查 Redirect URI 是否填写错误，确保其值包含 http://127.0.0.1:766/callback，而不是 https://127.0.0.1:766/callback。

特别注意 Copy Section

如果你在 2025 年 4 月 9 日前创建并配置过自定义 API Client，请务必前往 Spotify Developer Dashboard 更新设置。由于 Spotify 调整了对重定向 URI 的要求，原本使用 localhost 的 URI 已不再被接受，你需要将原先的：

http://localhost:766/callback

替换为：

http://127.0.0.1:766/callback

请进入对应应用的设置页面，并在 Redirect URI 中添加 http://127.0.0.1:766/callback。完成后即可正常使用自定义 API Client 进行授权。

⚠️ 注意：127.0.0.1 是 localhost 的等效 IP 地址，在当前 Spotify 的校验机制中被视为有效地址，而 localhost 会被拒绝。