0 引言
Waylyrics 是一款同时支持 Wayland 和 X11 的桌面歌词软件。它支持加载本地歌词，也能从网易云音乐、QQ 音乐等地方下载歌词。
Waylyrics 使用 MPRIS 与音乐播放器通讯，理论上所有支持 MPRIS 的音乐播放器都能使用 Waylyrics 显示桌面歌词。
1 安装 Waylyrics
开发者并未专门给 Debian 打包，个人建议使用 Flatpak 进行安装：
或直接执行如下命令：
flatpak install flathub io.github.waylyrics.Waylyrics
对于 Fedora、Arch Linux 用户，则分别可从 Fedora Copr 和 Archlinuxcn 软件源进行安装。
对于 Ubuntu 用户，开发者给出了自行编译的方法，也可以使用星火应用商店安装。
2 使用与配置
2.1 配置文件的位置
Waylyrics 的配置文件的路径如下：
- 对于 Flathub 版，在
~/.var/app/io.github.waylyrics.Waylyrics/config/waylyrics/config.toml - 对于其他版本，在
~/.config/waylyrics/config.toml
下文提升您需要编辑 config.toml 时，请根据安装的版本寻找这一文件。
2.2 歌词搜索
默认情况下，Waylyrics 会加载音频文件所在文件夹下，与音频文件同名 的歌词文件。
比如，现在正在播放的音频文件是
~/一半一半.ogg[1]，那么 Waylyrics 首先会尝试加载~/一半一半.lrc。
如果找不到，Waylyrics 会从网络服务器上搜索，默认是先从网易云音乐上搜索。
如果想从其他服务器搜索，请编辑 config.toml 第 37 行 lyric-search-source = ["网易云音乐"]。
可选的服务器有：
网易云音乐QQ音乐LRCLib
2.3 窗口行为
- 置顶：要将 Waylyrics 的窗口置顶，首先需要您当前使用的窗口管理器支持置顶功能。
一般而言，右键点击 Waylyrics 的窗口边框，再点击弹出菜单中诸如 “常居顶端” 的选项即可。 - 隐藏窗口边框：有两种操作方式，
- 点击 Waylyrics 的托盘图标，再点击弹出菜单中的 “开关边框” 即可。
- 点击 Waylyrics 窗口，按
Ctrl+D即可。
- 允许（或禁止）鼠标点击歌词后面的内容：有两种操作方法：
- 击 Waylyrics 的托盘图标，再点击弹出菜单中的 “开关穿透” 即可。
- 点击 Waylyrics 窗口，按
Alt+P即可。
2.4 更换主题
要更换 Waylyrics 的主题，请编辑 config.toml 第 18 行 theme = "default"。保存后请重启 Waylyrics。
Waylyrics 有如下主题可供选择：
"default"
"default-dark"
"no-background"
"ocean"
"trans"
