Wails v3 · Go 1.21+ · GPL v3

MusicLite Cuckoo 轻量级、跨平台的离线音乐播放器

面向本地音乐的桌面播放器。所有曲目、封面、歌词与统计数据均保存在本地,不依赖网络服务,无需登录账户。Windows、Linux 与 macOS 使用同一套代码构建。

最新版本
MusicLite 新 UI 主界面
新风格 UI · 中文主界面
01 / 最新发布

正在获取最新发布信息…

从 GitHub 仓库拉取最新 release 标题与说明。

标签 发布
查看完整发布说明与下载
02 / 特性

覆盖本地播放的完整链路

从媒体库管理到歌词显示,从全局控制到数据迁移,每一项功能都围绕"本地优先"的使用场景设计。

界面定制 designer

内置设计器实时调整圆角、模糊、阴影、辉光与动画级别等视觉令牌。支持透明背景与自定义背景图片,无需修改代码即可改变外观。

歌词系统 lrc

支持 LRC 格式歌词,提供卡片与全屏两种显示模式,可在淡入淡出、滑动、缩放、翻转、旋转等多种行切换动画间切换。

播放队列 queue

拖拽排序、随机播放、从媒体库批量添加,队列内支持直接拖放。关闭主窗口时最小化至托盘,播放不被打断。

全局快捷键 hotkey

可自定义播放/暂停、上一曲、下一曲的全局热键,应用处于后台或最小化状态时仍可响应,无需切回窗口。

多语言 i18n

内置中文与英文界面,翻译数据随应用分发。提供扩展机制,用户可自行添加或修改翻译条目。

设置迁移 .msclte.zip

一键打包设置与字体为 .msclte.zip 压缩包,在新设备上导入即可还原全部偏好,便于在多机环境间同步配置。

音量控制 volume

Windows 下支持应用级音量合成器控制,仅调节本程序音量而不影响系统其他进程;也可切换为系统主音量模式。

系统托盘 tray

自绘托盘菜单,支持后台播放与快速操作。关闭主窗口默认最小化至托盘,退出需通过托盘菜单显式确认。

标签打包 id3v2

将曲目、封面、歌词嵌入 ID3v2 标签并复制到剪贴板,单文件即可携带完整元数据,便于传输与分享。

听歌统计 stats

记录每首歌曲的累计播放时长,本地存储,可按曲目查看个人 listening 历史,数据不外传。

03 / 界面

两套 UI 风格,可实时切换

传统 UI 偏向稳定的控件布局,新风格 UI 采用更紧凑的间距与半透明质感。两套风格共享同一套设计令牌,切换不会丢失任何数据。

传统 UI 中文主界面
传统 UI · 主界面01
新 UI 中文主界面
新风格 UI · 主界面02
传统 UI 设计器
设计器 · 视觉令牌调节03
新 UI 半透明背景
新风格 UI · 半透明背景04
04 / 格式

支持的音频格式

解码能力基于 FFmpeg,早期版本(Cuckoo Beta0.6.4 及以前)仅支持三种基础格式,后续版本扩展至十四种。

格式 至 Cuckoo Beta0.6.4 Cuckoo Beta0.6.4 之后
MP3完整支持完整支持
WAV完整支持完整支持
FLAC完整支持完整支持
AAC不支持完整支持
OGG (Vorbis)不支持完整支持
OPUS不支持完整支持
WMA不支持部分支持
AIFF不支持完整支持
AMR不支持完整支持
AC3 / E-AC3不支持完整支持
DTS不支持完整支持
ALAC不支持完整支持
APE不支持仅解码
TTA不支持仅解码
05 / 技术栈

构建依赖

核心由 Go 与 Wails v3 构成,音频解码依赖 FFmpeg。所有依赖均为开源项目。

Go 桌面应用框架,提供窗口、托盘、事件系统与服务绑定。
音频解码后端,支撑 MP3 之外的所有扩展格式。
音频元数据与标签解析库。
Go 1.21+
后端语言与运行时。
Node.js 18+
前端构建工具链运行环境。
06 / 开始使用

获取与构建

可下载预编译版本直接运行,也可从源码自行构建。源码构建需要先准备 Go、Node.js 与 CGO 依赖。

环境要求

CGO 依赖因平台而异:

# Windows MinGW-w64, ffmpeg # macOS brew install ffmpeg # Linux sudo apt install \ libgtk-3-dev \ libwebkit2gtk-4.1-dev ffmpeg

从源码构建

# 安装前端依赖 cd frontend && npm install && cd .. # 启动开发服务器 wails3 dev # 构建生产版本 wails3 build # macOS / Linux compile.cmd # Windows

构建产物位于 build/bin/ 目录。