目前 waylyrics 暂时处于不活跃开发，两位主要开发者忙于生计，暂时只进行 PR Review / 依赖更新
遇到问题请参考 issues 和 wiki, discussion 等
Waylyrics 是一款支持 Linux/Windows 的桌面歌词软件。
关键特性：
- 基于 GTK 4
- 保持最新的依赖
- 自动切换亮暗主题
- 配置文件使用 TOML 格式
- 启动时会为配置文件添加最新注释
- CSS 自定义主题，提供多种预设主题
- 理论上正确接入 MPRIS/SMTC 即可兼容
- 通过社区贡献，优化了一部分音乐播放器的歌词接入
边框可以隐藏（ctrl-d/托盘菜单->开关边框）
注意：最低需要Rust版本为 1.78.0
Ubuntu用户详阅 BUILD_GUIDE_UBUNTU.zh_cn.md
另见 desktop文件
Lines 67 to 71 in d2132b4
- 播放器需至少在MPRIS提供 Position，Metadata(有title)，PlaybackStatus
- 需要你的wm允许你设置窗口置顶
| 插件 | 简介 | 版本 |
|---|---|---|
| waylyrics-sakura-translator | 日译中翻译插件，基于SakuraLLM | v0.3.6+ |
| 名称 | 在线 | 框架 | 备注 |
|---|---|---|---|
| Firefox | O | 浏览器 | 需要插件 |
| Chrome | O | 浏览器 | |
| DeaDBeeF | X | GTK3 | deadbeef-mpris2-plugin |
| netease-cloud-music-gtk | O | GTK4 | 2.3.0+ |
| amberol | X | GTK4 | |
| lollypop | X | GTK4 | |
| FeelUOwn | O | Qt5 | 3.9.12+ |
| VLC | O | Qt5 | |
| Qcm | O | Qt6 | |
| Telegram | O | Qt6 | |
| Electron-NCM | O | Electron | |
| YesPlayMusic | O | Electron | R3Play会给标题加额外的后缀 |
| youtube-music | O | Electron | 启用Shortcut |
| go-musicfox | O | bubbletea | 4.3.2+ |
| mpv | O | 原生 | mpv-mpris |
| ncmpcpp | X | ncursew | mpd-mpris |
| 名称 | 在线 | 框架 | 备注 |
|---|---|---|---|
| FeelUOwn | O | Qt5 | 4.0.1+ |
| SPlayer | O | Electron | |
| go-musicfox | O | bubbletea | 4.4.0+ |
| 媒体播放器 | X | UWP | 拖拽后不会立即更新 |
| Player | OSD | issue | 备注 |
|---|---|---|---|
| qqmusic | O | 位置一直为0 | |
| listen1-desktop | O | 位置一直为0 |
一般情况会创建的目录（可能被用户XDG设置影响）
~/.cache/waylyrics/XX/...
~/.config/waylyrics/...
# waylyrics 会首先尝试在这里加载主题，找不到的话就从全局模板目录找
~/.local/share/waylyrics/_themes/...
%AppData%\poly000\waylyrics\config
%AppData%\poly000\waylyrics\data
%LocalAppData%\poly000\waylyrics\cache
| 名称 | 技术栈 | 桌面支持 | 播放器支持 | 备注 |
|---|---|---|---|---|
| lyric-for-musicfox | Qt/C++ | * | musicfox | |
| waybar-netease-music-lyrics | bash | wlroots-based | NCM1 | |
| Sunamu | Electron/TS | X/Xwayland | MPRIS | |
| desktop-lyric | JavaScript | GNOME | MPRIS | |
| caraoke-plasmoid | QML | Plasma | MPRIS | |
| osdlyrics | GTK2/C+Python | X/Xwayland | MPRIS | |
| lyricsSeeker | Python+QML | Plasma | WIP | |
| desktop_lyric | egui | Plasma | MPRIS | |
| lyrica | Rust+QML | Plasma | MPRIS |
| 名称 | 技术栈 | 播放器支持 | 备注 |
|---|---|---|---|
| 可道歌词 | C++ | Windows Media Player Foobar2000 AIMP Winamp |
|
| Lyricify | UWP/C#(4+) C#(3-) |
Spotify iTunes Apple Music Music Center QQ Music Netease Cloud Music YesPlayMusic |
|
| 热词 | WinUI3 | HyPlayer LyricEase YesPlayMusic GSMTCs2 |
- gtk4-rs, Rust bind to GTK-4.
This project icon is licensed under a Creative Commons Attribution 4.0 International License.