🎵 XCMusic：高颜值第三方网易云音乐客户端 🎶
📍 项目亮点
XCMusic 是一款基于Vue3+Electron开发的开源、跨平台网易云音乐客户端。
此音乐播放器基于 Electron 开发，旨在为用户提供简洁、美观、兼容多平台的音乐体验。项目代码易于扩展和定制，支持多种音乐格式播放，界面简洁流畅。
兼容Windows、macOS 和 Linux的音乐播放器。它不仅支持常见的音乐格式，还提供歌词显示、播放辅助、主题切换等功能。
其特色功能包括：
▌ 核心优势：
✔️ 原生歌词特效：支持卡拉OK式逐字滚动
✔️ 无损音质解析：突破客户端音质限制
✔️ 主题自定义：CSS样式深度定制
▌ 主要功能：
- 🎵 多格式支持：MP3、FLAC、WAV、AAC等主流音频格式
- 📱 跨平台能力：iOS、Android、Windows、macOS全平台覆盖
- 🔄 播放控制：播放/暂停、上一曲/下一曲、进度调节
- 🎚️ 音频处理：均衡器、音量调节、音效增强
- 📊 元数据管理：ID3标签读取与编辑
2.2 技术架构
🎧 功能全景
| 功能模块 | 技术特性 | 应用场景 |
|---|---|---|
| 🎹 频谱可视化 | WebGL实时渲染 & 主题联动 | 音乐播放可视化 |
| 📻 私人FM | 智能推荐算法 & 红心收藏 | 个性化音乐推荐 |
| 🎨 主题工坊 | CSS变量注入 & 热重载 | 界面个性化定制 |
| 🔄 多端同步 | WebDAV协议 & 增量同步 | 歌单跨设备同步 |
🚀 快速安装
以下操作均基于Node.js，如果没有安装，请先安装Node.js，建议使用nodejs 20及以上版本。
可以使用electron或者tauri作为项目后端，由于tauri后端并未完全适配，更建议使用electron后端。
安装依赖
npm install
使用electron
运行Electron程序
npm run electron:serve
打包为二进制程序
npm run electron:build
如果在mac上因为找不到python出错，请在安装python后执行
node ./scripts/mac_build.js
使用tauri
-
打包网易云音乐api程序:
- 下载本仓库或克隆仓库:yiktllw/NeteaseCloudMusicApi
- 在
NeteaseCloudMusicApi目录下，安装依赖:
npm install- 在
NeteaseCloudMusicApi目录下，修改app.js的start函数为:
async 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平台
npm run pkgwinlinux平台
npm run pkglinuxmacos平台
npm run pkgmacos- 在
NeteaseCloudMusicApi/bin目录下，找到打包的程序，并将其复制到XCMusic/src-tauri/resources/api目录下。
-
安装Rust开发环境
-
运行tauri程序:
npm run tauri:serve
- 打包为二进制程序:
npm run tauri:build
# Windows 用户
choco install xcmusic
# macOS 用户
brew install --cask xcmusic
# Linux 用户
sudo apt-get install xcmusic
🔧 高级配置
1. 主题自定义
/* 自定义主题示例 */
: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博客
