🎵 MusicBox

高颜值的本地音乐播放器

🌐 官方网站  |   📦下载安装  |   🛠️开发指南  |   🔧为MusicBox安装（开发）插件  |   📌相关截图

---

📖 项目简介

• MusicBox是一款专注于本地音乐播放的桌面应用程序，采用现代化的技术栈和精美的用户界面设计。
• 项目灵感来源于 YesPlayMusic 的设计美学。

✨ 特性

• 💻️ 支持 Windows / macOS / Linux
• ✅ 支持flac, mp3, wav, ogg, m4a, aac, wma等多种音乐格式
• 🔧 强大的插件系统（允许在插件中实现任何功能，高权限）
• 📔 支持在线获取歌曲封面和歌词
• ⌨️ 支持自定义局内/全局快捷键
• 🎈 浅色/深色主题切换
• 🎼 支持均衡器
• 📃 支持桌面显示歌词
• 📔 支持识别内嵌封面和内嵌歌词
• 👁️ 支持自由的页面显示开关
• 💾 支持挂载 SMB/WebDAV 等网络磁盘
• 🖋️ 支持编辑歌曲元数据
• ▶️ 支持无间隙播放，为连续的专辑歌曲提供更好的播放体验
• 🛠️ 更多特性开发中

📔 TODOS

✅已完成，❌未完成，🔄进行中，❓待定

• ✅ 硬件加速
• 🔄 重构插件系统
• ❌ 歌词逐字
• ❌ 修复播放列表存在的问题
• ❌ 歌词样式调整

📦 安装

预编译版本下载

前往 Releases 页面下载适合你系统的安装包。

从源码构建

环境要求

• Node.js >= 22.18.0
• python >= 3.8

从源码构建 MusicBox，请按照以下步骤操作：

1. 克隆仓库

git clone https://github.com/asxez/MusicBox.git
cd MusicBox

2. 安装依赖

# 安装主进程依赖
npm install

# 安装渲染进程依赖并构建
cd src/renderer
npm install
npm run build
cd ../..

3. 开发模式运行

npm run dev:main

4. 构建应用

# 构建当前平台版本
npm run build

🛠️ 开发

项目架构

见MusicBox 架构文档

🔧 插件开发

插件系统正在重构中...

可用插件列表

插件系统正在重构中...

🤝 贡献

我们欢迎所有形式的贡献！无论是报告 bug、提出功能建议、提交代码改进，或者说提交你开发的插件！

📄 许可证

本项目基于 MIT License 开源协议。

🙏 致谢

• YesPlayMusic - 设计灵感来源
• Electron - 跨平台桌面应用框架
• LrcApi - 提供相关接口
• music-metadata - 音频元数据解析
• 所有为项目做出贡献的开发者们

📌 相关截图

---

如果你喜欢这个项目，请给它一个 ⭐️