【开源】一个基于 Vue3 和 Electron 开发的第三方网易云音乐客户端,具有与官方客户端相似的界面布局

🎵 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

  1. 打包网易云音乐api程序:

    1. 下载本仓库 克隆仓库:yiktllw/NeteaseCloudMusicApi
    2. NeteaseCloudMusicApi目录下,安装依赖:
    shell 复制代码
    npm install
    1. NeteaseCloudMusicApi目录下,修改app.jsstart函数为:
    javascript 复制代码
    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,
      });
    }
    1. NeteaseCloudMusicApi目录下,根据平台运行命令:

    win平台

    shell 复制代码
    npm run pkgwin

    linux平台

    shell 复制代码
    npm run pkglinux

    macos平台

    shell 复制代码
    npm run pkgmacos
    1. NeteaseCloudMusicApi/bin目录下,找到打包的程序,并将其复制到XCMusic/src-tauri/resources/api目录下。
  2. 安装Rust开发环境

  3. 运行tauri程序:

shell 复制代码
npm run tauri:serve
  1. 打包为二进制程序:
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博客

相关推荐
修己xj5 小时前
TypeWords:让英语学习更高效的打字练习神器
开源
程序员爱钓鱼10 小时前
Node.js 编程实战:理解 Buffer 与 Stream
后端·node.js·trae
程序员爱钓鱼12 小时前
Node.js 编程实战:npm和yarn基础使用
后端·node.js·trae
程序员爱钓鱼12 小时前
Node.js 编程实战:CommonJS 与ES6 模块
后端·node.js·trae
1新112 小时前
树莓派5 + 本地大模型(Qwen) + 离线语音 = 打造毫秒级“贾维斯”
开源
CoderJia程序员甲14 小时前
GitHub 热榜项目 - 日榜(2025-12-7)
git·ai·开源·llm·github
孟祥_成都16 小时前
nest.js / hono.js 一起学!hono的设计思想!
前端·node.js
星空椰16 小时前
Windows 使用nvm多版本管理node.js
windows·node.js
EterNity_TiMe_17 小时前
使用openEuler来测试GCC编译效率实战测评
开源·操作系统·gcc·openeuler·实战测评
我叫唧唧波17 小时前
【自动化部署】基于Docker构建CI/CD流水线
ci/cd·docker·node.js