桌面歌词显示设置与常见问题

开启桌面歌词

Listen 1 桌面版（Electron）和浏览器插件版都支持桌面歌词：

桌面版

1. 打开 Listen 1 设置（右上角齿轮图标）
2. 在「歌词」选项下找到「显示桌面歌词」
3. 勾选后即可在窗口外看到独立的桌面歌词浮窗

插件版

Chrome / Firefox 插件的桌面歌词需要插件权限支持（需要「总是允许」或「固定标签页」模式）。有些浏览器限制可能影响桌面歌词弹出。

歌词浮窗操作

桌面歌词浮窗有以下交互：

• 双击歌词：打开或跳转到 Listen 1 主界面
• 右键歌词：弹出设置菜单，可以调整：
• 歌词字体（支持系统中文字体和英文字体）
• 字体大小（8px ~ 72px）
• 字体颜色（前景色 / 背景描边）
• 背景透明度
• 是否始终置顶
• 是否显示进度
• 是否允许拖拽
• 拖拽浮窗：在允许拖拽的情况下，按住浮窗任意位置拖到屏幕任意位置

默认外观

Listen 1 桌面歌词的默认样式：

• 白底黑字，歌词居中显示
• 单行或双行滚动显示当前正在播放的歌词
• 没有背景遮罩，纯文字浮窗

部分修改版（社区 Fork）增加了更丰富的外观选项，如毛玻璃效果、渐变背景、自动隐藏等。

快捷键切换歌词显示

在 Listen 1 内播放时，按 Ctrl + L（macOS 上 Cmd + L）可以快速切换歌词显示开关——适合需要暂时隐藏歌词时使用。

歌词来源与缺失原因

Listen 1 从各音乐平台的歌词 API 获取同步歌词。歌词缺失可能有以下原因：

• 纯音乐 / 古典音乐：很多纯音乐没有歌词，歌词区域只会显示歌曲名
• Bilibili 来源：视频歌曲的歌词不一定有同步数据
• 新发行曲目：刚上线的歌曲可能还没有平台匹配同步歌词
• 版权限制：某些平台的歌词数据不对外接口开放

歌词缺失时，Listen 1 会尝试其他平台的歌词源。如果全部失败，只显示歌曲名和歌手。

与各平台官方播放器的歌词差异

Listen 1 的歌词来自平台公开 API，与官方播放器显示的歌词基本一致。但偶尔会出现：

• 歌词版本不同步（如官方有修正版，Listen 1 还在用旧版）
• 某些歌曲有多个版本歌词，Listen 1 选取的不一定是你想要的版本
• 部分平台的翻译歌词不在公开接口里，Listen 1 拿不到

如果发现歌词明显错误，可以去各平台官方播放器核对。