lmplayer

项目概述

wmPlayer（仓库名 lmplayer）是一款基于 Rust 与 GTK4 + WebKitGTK 构建的现代化音乐播放器，主打 Linux 桌面环境的深度集成。它把前端界面放进原生无边框窗口，后端用纯 Rust 实现酷狗协议引擎，无需外部 Node.js 进程即可完成加签、解密与歌词解码。除了在线流媒体与无损音质播放，它还提供本地音乐管理、音频缓存池、系统托盘和独立的桌面悬浮歌词。

把在线流媒体、本地曲库和桌面歌词装进一个原生窗口。

主要功能

• 在线音乐：支持音质解析（标准、高品、无损、Hi-Fi）、关键词联想搜索、新歌与飙升榜单
• 扫码登录：支持扫码登录与会话持久化，登录后可使用歌单与个性化推荐
• 本地音乐管理：扫描并播放本地音频，提供本地播放列表、收藏夹与播放历史
• 音频缓存池：已播放音频智能缓存复用，减少带宽开销并加快拖拽起播
• 沉浸播放：黑胶唱片旋转动效、动态封面模糊背景与逐字变色高亮歌词
• 多套主题：浅色、深色、毛玻璃浅色与磨砂深色，一键即时切换
• 系统托盘：适配 StatusNotifierItem 规范，支持后台常驻与播放控制
• 桌面歌词：配套独立悬浮歌词程序，可调透明度、字体缩放与逐字高亮颜色
• 多媒体按键：支持 MPRIS 多媒体控制规范与全局多媒体快捷键

适用人群

• 使用 Linux 桌面、喜欢原生应用的音乐爱好者
• 希望在电脑上收听在线音乐与本地曲库的用户
• 需要桌面悬浮歌词与托盘控制的用户

快速上手

1. 从 Releases 下载对应平台的压缩包并解压，或从源码构建
2. 首次运行按需安装系统依赖：Ubuntu 系可执行 sudo apt install libgtk-4-dev libwebkitgtk-6.0-dev libsoup-3.0-dev
3. 启动程序后，在发现页浏览推荐，或用搜索页按关键词查找歌曲
4. 需要登录时使用扫码登录，登录状态会本地持久化
5. 在设置中把本地音乐目录加入曲库，扫描后即可在本地音乐页播放
6. 需要桌面歌词时，另行安装配套的 OSD 悬浮歌词程序或 KDE Plasma 挂件

核心优势

• 纯 Rust 引擎：加签、解密与歌词解码全部用 Rust 实现，不再依赖外部 Node.js 进程
• 单文件自包含：前端资源编译进可执行文件，开箱即用、不留散落依赖
• 离线可用：图标与字体资产本地打包，断网时界面依然完整渲染
• 桌面深度集成：托盘、多媒体按键与桌面歌词都按 Linux 桌面规范实现

系统要求

项目	要求
操作系统	Linux（GTK4 + WebKitGTK 6.0）
运行时	Rust 1.75 或更高，编译前端需 Node.js 18 及以上
系统依赖	libgtk-4、libwebkitgtk-6.0、libsoup-3.0 等
网络	在线播放需要联网

注意事项

• 本项目是基于公开接口与协议开发的第三方客户端，并非酷狗官方客户端
• 仅供个人学习与编程技术研究使用，请尊重音乐版权、支持正版
• 使用过程中可能产生版权数据，建议在 24 小时内清除产生的缓存
• 针对 NVIDIA 驱动环境默认启用 WEBKIT_DISABLE_DMABUF_RENDERER 以规避界面卡死