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

发布于:2025-05-21 ⋅ 阅读:(47) ⋅ 点赞:(0)

🎵 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后端。

安装依赖

npm install

使用electron

运行Electron程序

npm run electron:serve

打包为二进制程序

npm run electron:build

如果在mac上因为找不到python出错,请在安装python后执行

node ./scripts/mac_build.js

使用tauri

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

    1. 下载本仓库克隆仓库:yiktllw/NeteaseCloudMusicApi
    2. NeteaseCloudMusicApi目录下,安装依赖:
    npm install
    
    1. NeteaseCloudMusicApi目录下,修改app.jsstart函数为:
    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平台

    npm run pkgwin
    

    linux平台

    npm run pkglinux
    

    macos平台

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

  3. 运行tauri程序:

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


网站公告

今日签到

点亮在社区的每一天
去签到