SimoHypers/limusic

项目介绍

Limusic 是一个原生桌面端 YouTube Music 客户端，采用 Rust + Tauri 构建、SvelteKit 编写界面。它直接调用 YouTube 的 InnerTube API 获取内容，音频交给 libmpv 播放，因此不需要打包浏览器运行时，也没有后端服务器。实际效果是无广告播放、无缝切歌、磁盘缓存，以及基于 YouTube 元数据的响度归一化。界面进程从不直接访问 YouTube：Rust 核心负责 API 调用，混淆过的流地址保护 JavaScript 在隐藏的 webview 中运行，与 UI 隔离。

除了播放，它还支持登录 YouTube Music 账号（应用内 Google 登录或粘贴 Cookie，多账号切换）、播放列表和收藏等写操作、播放历史、同步歌词（可选逐词高亮）、可选音乐视频、带电台续播的队列、Last.fm 与 ListenBrainz 记录、Discord Rich Presence、系统媒体键、托盘、Mini Player 等。适合已经在桌面端使用 YouTube Music、希望换成更轻量的原生播放器并需要 scrobbling 和更多控制项的用户。

快速开始

安装包发布在 Releases 页面。按平台选择：

平台	文件	说明
Windows	-setup.exe	可自动更新
Windows	.msi	不能自动更新
Linux	.AppImage	可自动更新，内置 libmpv，需 glibc 2.39+
Linux（Ubuntu/Debian）	.deb	apt 会自动安装 libmpv 和 webkit2gtk
Linux（Fedora/RHEL）	.rpm	需先安装 mpv-libs（sudo dnf install mpv-libs）
macOS（Apple Silicon）	.dmg	未签名，首次启动需执行 xattr -dr com.apple.quarantine /Applications/limusic.app

Intel Mac 没有预编译包，需按 BUILD-PLATFORMS.md 从源码构建。Arch、Fedora COPR 和 openSUSE Tumbleweed 另有社区维护的软件源（例如 Arch 上 yay -S limusic-bin），由各自维护者更新。

启动后在应用内登录 YouTube Music，即可搜索和播放。可选集成：点标题栏的 Last.fm 图标并在浏览器中授权；在 Settings ▸ Scrobbling 粘贴 ListenBrainz 用户 token；点 Discord 图标开关 Rich Presence。歌词面板由播放栏的麦克风按钮打开。

Fedora 上从源码构建：

sudo dnf install mpv-libs mpv-libs-devel webkit2gtk4.1-devel \
  gcc gcc-c++ make openssl-devel librsvg2-devel
cd ui && pnpm install && cd ..
cargo tauri build

若要用 Listen Together 自建同步听歌房间，需运行中继服务：cargo run -p sync-server，它在 0.0.0.0:8080 上提供明文 WebSocket；前面接一个处理 TLS 的组件，再把得到的 wss:// 地址粘贴到应用的 Listen Together 面板。

使用约束

• 官方发布覆盖 Windows、Linux 和 Apple Silicon macOS；Intel Mac 只能从源码构建。
• Linux 各包要求不同：AppImage 需 glibc 2.39+（Ubuntu 24.04+、Debian 13+、Fedora 40+）；RPM 方式需 mpv-libs；.deb 和 .rpm 不支持自动更新。
• macOS .dmg 未签名，首次启动前必须清除隔离属性。
• 从源码构建时若没有 src-tauri/lastfm.keys（需自行在 Last.fm API 页面 申请 LIMUSIC_LASTFM_API_KEY 与 LIMUSIC_LASTFM_API_SECRET），其他功能仍可编译运行，只是 Last.fm 按钮会提示未配置。
• 逐词歌词依赖 Boidu，默认会为每首歌请求该源；可在设置中关闭，其他源只提供整行歌词。YouTube Music 自带歌词按地区授权，部分地区完全缺失。
• Last.fm 在播放过半或满 4 分钟（以先到者为准）时记录；ListenBrainz 新账号需先验证邮箱。
• 项目与 YouTube、Google 无隶属关系，许可证为 GPL-3.0。

HotRepo 点评

在 2026-11-01 的 HotRepo Rust 月榜上，Limusic 以 1,550 Star（当月新增 872）出现在第 20 名。目前只有这一条快照，它说明的是单日事实而非趋势，项目在全部语言日榜上也没有已记录的名次。不过这份语言榜月榜数据至少显示：在桌面端通常由 Electron 应用或网页版满足的 YouTube Music 场景里，一个原生 Rust 客户端在那个月获得了关注；这一关注能否持续超过一个月，现有数据还看不出来。