🎵 XCMusic:高颜值第三方网易云音乐客户端 🎶

📍 项目亮点
XCMusic 是一款基于Vue3+Electron开发的开源、跨平台网易云音乐客户端。
此音乐播放器基于 Electron 开发,旨在为用户提供简洁、美观、兼容多平台的音乐体验。项目代码易于扩展和定制,支持多种音乐格式播放,界面简洁流畅。
兼容Windows、macOS 和 Linux的音乐播放器。它不仅支持常见的音乐格式,还提供歌词显示、播放辅助、主题切换等功能。
其特色功能包括:
▌ 核心优势:
✔️ 原生歌词特效 :支持卡拉OK式逐字滚动
✔️ 无损音质解析 :突破客户端音质限制
✔️ 主题自定义:CSS样式深度定制
▌ 主要功能:
- 🎵 多格式支持:MP3、FLAC、WAV、AAC等主流音频格式
- 📱 跨平台能力:iOS、Android、Windows、macOS全平台覆盖
- 🔄 播放控制:播放/暂停、上一曲/下一曲、进度调节
- 🎚️ 音频处理:均衡器、音量调节、音效增强
- 📊 元数据管理:ID3标签读取与编辑
2.2 技术架构
音频解码 播放引擎 UI界面 平台适配层 iOS/Android/PC
🎧 功能全景
功能模块 | 技术特性 | 应用场景 |
---|---|---|
🎹 频谱可视化 | WebGL实时渲染 & 主题联动 | 音乐播放可视化 |
📻 私人FM | 智能推荐算法 & 红心收藏 | 个性化音乐推荐 |
🎨 主题工坊 | CSS变量注入 & 热重载 | 界面个性化定制 |
🔄 多端同步 | WebDAV协议 & 增量同步 | 歌单跨设备同步 |
🚀 快速安装
以下操作均基于Node.js,如果没有安装,请先安装Node.js,建议使用nodejs 20及以上版本。
可以使用electron或者tauri作为项目后端,由于tauri后端并未完全适配,更建议使用electron后端。
安装依赖
shell
npm install
使用electron
运行Electron程序
shell
npm run electron:serve
打包为二进制程序
shell
npm run electron:build
如果在mac上因为找不到python出错,请在安装python后执行
bash
node ./scripts/mac_build.js
使用tauri
-
打包网易云音乐api程序:
- 下载本仓库或 克隆仓库:yiktllw/NeteaseCloudMusicApi
- 在
NeteaseCloudMusicApi
目录下,安装依赖:
shellnpm install
- 在
NeteaseCloudMusicApi
目录下,修改app.js
的start
函数为:
javascriptasync function start() { // 检测是否存在 anonymous_token 文件,没有则生成 if (!fs.existsSync(path.resolve(tmpPath, "anonymous_token"))) { fs.writeFileSync(path.resolve(tmpPath, "anonymous_token"), "", "utf-8"); } // 启动时更新anonymous_token const generateConfig = require("./generateConfig"); await generateConfig(); require("./server").serveNcmApi({ checkVersion: false, port: 43210, }); }
- 在
NeteaseCloudMusicApi
目录下,根据平台运行命令:
win平台
shellnpm run pkgwin
linux平台
shellnpm run pkglinux
macos平台
shellnpm run pkgmacos
- 在
NeteaseCloudMusicApi/bin
目录下,找到打包的程序,并将其复制到XCMusic/src-tauri/resources/api
目录下。
-
安装Rust开发环境
-
运行tauri程序:
shell
npm run tauri:serve
- 打包为二进制程序:
shell
npm run tauri:build
bash
# Windows 用户
choco install xcmusic
# macOS 用户
brew install --cask xcmusic
# Linux 用户
sudo apt-get install xcmusic
🔧 高级配置
1. 主题自定义
css
/* 自定义主题示例 */
:root {
--primary-color: #2196F3;
--background-image: url('https://example.com/bg.jpg');
}
TIP: 配置文件路径:~/.config/xcmusic/custom.css
2. 主要快捷键
组合键 | 功能描述 |
---|---|
Ctrl+Shift+L |
开启/关闭歌词面板 |
Alt+←/→ |
上一曲/下一曲 |
5、每日资源 在这里
💯 👉【我的更新汇总】
👉项目下载
关注我的CSDN博客
更多资源可以查看我的CSDN博客