Waylyrics

Telegram |  Matrix
功能预览

• Waylyrics
  • 构建/安装
  • 用法
  • 依赖
  • 插件
  • 推荐的播放器
    • Linux
    • Windows
  • 无法使用的播放器
  • 目录
    • Linux/Unix
    • Windows
  • 替代品
    • Linux
    • Windows
  • Credit
  • License

构建/安装

详阅 INSTALLATION.md

Ubuntu用户详阅 BUILD_GUIDE_UBUNTU.zh_cn.md

用法

另见 desktop文件

waylyrics/src/config.rs

Lines 67 to 71 in d2132b4

	switch_decoration: "<Control>d".into(),
	reload_theme: "<Control><Shift>t".into(),
	search_lyric: "<Control>s".into(),
	refetch_lyric: "<Alt><Shift>l".into(),
	switch_passthrough: "<Alt>p".into(),

依赖

• 播放器需至少在MPRIS提供 Position，Metadata(有title)，PlaybackStatus
• 需要你的wm允许你设置窗口置顶

插件

插件	简介	版本
waylyrics-sakura-translator	日译中翻译插件，基于SakuraLLM	v0.3.6+

推荐的播放器

Linux

名称	在线	框架	备注
Firefox	O	浏览器	需要插件
Chrome	O	浏览器
netease-cloud-music-gtk	O	GTK4	2.3.0+
amberol	X	GTK4
lollypop	X	GTK4
FeelUOwn	O	Qt5	3.9.12+
VLC	X	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

Windows

名称	在线	框架	备注
FeelUOwn	O	Qt5	4.0.1+
go-musicfox	O	bubbletea	4.4.0+
媒体播放器	X	UWP	拖拽后不会立即更新

无法使用的播放器

Player	OSD	issue	备注
qqmusic	O	位置一直为0
listen1-desktop	O	位置一直为0

目录

一般情况会创建的目录（可能被用户XDG设置影响）

Linux/Unix

~/.cache/waylyrics/XX/...
~/.config/waylyrics/...
# waylyrics 会首先尝试在这里加载主题，找不到的话就从全局模板目录找
~/.local/share/waylyrics/_themes/...

Windows

%AppData%\poly000\waylyrics\config
%AppData%\poly000\waylyrics\data
%LocalAppData%\poly000\waylyrics\cache

替代品

Linux

名称	技术栈	桌面支持	播放器支持	备注
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

Windows

名称	技术栈	播放器支持	备注
可道歌词	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

Credit

• gtk4-rs, Rust bind to GTK-4.

License

The MIT License (MIT)

This project icon is licensed under a Creative Commons Attribution 4.0 International License.

Footnotes

1. https://github.com/kangxiaoju/waybar-netease-music-lyrics/blob/f84810fe1628ca38fa36d88506152d88cf0e77e4/song.sh#L41-L59 ↩