【开源】一个基于 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博客

相关推荐
ZStack开发者社区5 小时前
ZSvirt 开源月报第 1 期 · Around the World
开源·云计算·vmware·虚拟化
冬奇Lab5 小时前
一天一个开源项目(第224篇):ARTEMIS —— 谷歌开源的移动端 AI 自动化框架,让 AI 助手像人一样操作手机
人工智能·开源·测试
caoerzhong7 小时前
JeeWMS 开源仓库管理系统全景解读:一套 Java WMS 如何把 WMS/OMS/BMS/TMS 装进同一个系统
java·开源
星核0penstarry10 小时前
从“一次生成“到“持续进化“:自进化社媒 Agent 的工作流拆解
人工智能·开源·agent
flash俊杰12 小时前
Electron 打包后窗口 30 秒不出现:一个 ABI 不匹配的血案
electron·node.js
行者全栈架构师13 小时前
大模型运维准确率不到 50%?我们用 DeepSeek V4 测了 5 大场景,结果出人意料
linux·人工智能·开源
@tangguo12314 小时前
npm 和 yarn 配置说明
前端·javascript·npm·node.js·yarn
Erishen16 小时前
tsm-hub:把 LLM、Tools、MCP、Skills 收进一个统一网关
架构·开源·agent
flash俊杰16 小时前
一套代码接入所有大模型:OpenAI 兼容适配器设计
node.js·openai
右耳朵猫AI16 小时前
Node.js周刊2026W38 | 进程中断缺陷修复、Copilot 迁至 Rust、Node 新增 VFS
javascript·后端·node.js