一款开源简洁高颜值的酷狗第三方客户端V1.0.0 Beta

admin 2025-08-20 09:14:19

MoeKoe Music

前言

早在10年前后的样子,那会在用网页版QQ的时候我就已经开始使用酷狗音乐了(也是十来年的老粉了),所以这些年收藏的歌曲全部都在上面.后来我也尝试开始使用网易云或QQ音乐,也尝试把酷狗的歌单导入进去,但是效果都不尽人意.我听的大多是日漫OP,好多歌曲都没办法找到.

兜兜转转最后还是回到酷狗,但是在Mac端的酷狗,时常可能会出现不能播放的情况,虽说界面没什么功能,但也挺好的.在网友的安利下,我现在一直是在酷狗的概念版上听歌,并且是市面上为数不多能免费听VIP歌曲的音乐播放软件了,力推.

我在我的个人介绍页面说我特别喜欢听歌,尤其是日漫OP.怎么证明呢?(之前我网页版歌单也年久失修了)那就自己开发一个音乐播放器.

✨ 特性

✅ 使用 Vue.js 全家桶开发

🔴 酷狗账号登录(扫码/手机/账号登录)

📃 支持歌词显示

📻 每日推荐歌曲

🚫🤝 无任何社交功能

🔗 官方服务器直连, 无任何第三方 API

✔️ 每日自动领取VIP, 登录就是VIP

🎨 主题色切换

👋 启动问候语

⚙️ 多平台支持

🛠 更多特性开发中

Todo List

[ ] 📺 支持 MV 播放

[ ] 🌚 Light/Dark Mode 自动切换

[ ] 👆 支持 Touch Bar

[ ] 🖥️ 支持 PWA,可在 Chrome/Edge 里点击地址栏右边的 ➕ 安装到电脑

[ ] 🟥 支持 Last.fm Scrobble

[ ] 🎧 支持 Mpris

[ ] ⌨️ 自定义快捷键和全局快捷键

[ ] 🤟 多语言支持

[ ] 📻 桌面歌词

[ ] ⚙️ 系统架构优化

[ ] 🎶 歌曲、歌单/收藏、取消

📦️ 安装

访问本项目的 Releases 页面下载安装包。

⚙️ 开发

克隆本仓库

复制代码

git clone https://github.com/iAJue/MoeKoeMusic.git

进入目录并安装依赖

复制代码

cd MoeKoeMusicnpm install

启动开发者模式

复制代码

npm run dev

打包项目

复制代码

npm run build

编译项目

Windows:

复制代码

npm run electron:build:win [默认 NSIS 安装包]

Linux:

复制代码

npm run electron:build:linux [默认 AppImage 格式]

macOS:

复制代码

npm run electron:build:macos [默认Apple Silicon架构]

更多命令请查看 package.json 文件 scripts

👷‍♂️ 编译客户端

如果在 Release 页面没有找到适合你的设备的安装包的话,你可以根据下面的步骤来打包自己的客户端。

安装 Node.js,并确保 Node.js 版本 >= 18.0.0。

使用 git clone https://github.com/iAJue/MoeKoeMusic.git 克隆本仓库到本地。

使用 npm install 安装项目依赖。

编译API服务端

Windows:

复制代码

npm run build:api:win

Linux:

复制代码

npm run build:api:linux

macOS:

复制代码

npm run build:api:macos

选择下列的命令来打包适合的你的安装包,打包出来的文件在 /dist_electron 目录下。了解更多信息可访问 electron-builder 文档

1. 打包 macOS 平台

通用的 macOS 包(Intel 和 Apple Silicon 双架构):

复制代码

npm run electron:build -- --mac --universal

仅 Intel 架构:

复制代码

npm run electron:build -- --mac --x64

仅 Apple Silicon 架构:

复制代码

npm run electron:build -- --mac --arm64

2. 打包 Windows 平台

默认 NSIS 安装包(适合大多数 Windows 用户):

复制代码

npm run electron:build -- --win

为 Windows 创建 EXE 文件和 Squirrel 安装包:

复制代码

npm run electron:build -- --win --ia32 --x64 --arm64 --target squirrel

–ia32 为 32 位 Windows 架构。

–x64 为 64 位 Windows 架构。

–arm64 为 ARM Windows 架构(Surface 等设备)。

为 Windows 生成便携式的 EXE 文件(免安装):

复制代码

npm run electron:build -- --win --portable

3. 打包 Linux 平台

默认 AppImage 格式(适用于大多数 Linux 发行版):

复制代码

npm run electron:build -- --linux

snap(适用于 Ubuntu 和支持 snap 的发行版):

复制代码

npm run electron:build -- --linux --target snap

deb(适用于 Debian/Ubuntu 系列):

复制代码

npm run electron:build -- --linux --target deb

rpm(适用于 Red Hat/Fedora 系列):

复制代码

npm run electron:build -- --linux --target rpm

4. 打包所有平台

如果需要同时生成 Windows、macOS 和 Linux 的安装包,可以使用以下命令:

复制代码

npm run electron:build -- -mwl

5. 自定义编译设置

您可以根据需要添加其他选项来进一步自定义打包,例如指定 x64 和 arm64 架构,或选择不同的目标格式。

☑️ 反馈

如有任何问题或建议,欢迎提交 issue 或 pull request。

免责声明

本程序是酷狗第三方客户端,并非酷狗官方,需要更完善的功能请下载官方客户端体验.

本项目仅供学习使用,请尊重版权,请勿利用此项目从事商业行为及非法用途!

使用本项目的过程中可能会产生版权数据。对于这些版权数据,本项目不拥有它们的所有权。为了避免侵权,使用者务必在 24 小时内清除使用本项目的过程中所产生的版权数据。

3.由于使用本项目产生的包括由于本协议或由于使用或无法使用本项目而引起的任何性质的任何直接、间接、特殊、偶然或结果性损害(包括但不限于因商誉损失、停工、计算机故障或故障引起的损害赔偿,或任何及所有其他商业损害或损失)由使用者负责。

禁止在违反当地法律法规的情况下使用本项目。对于使用者在明知或不知当地法律法规不允许的情况下使用本项目所造成的任何违法违规行为由使用者承担,本项目不承担由此造成的任何直接、间接、特殊、偶然或结果性责任。

音乐平台不易,请尊重版权,支持正版。

本项目仅用于对技术可行性的探索及研究,不接受任何商业(包括但不限于广告等)合作及捐赠。

如果官方音乐平台觉得本项目不妥,可联系本项目更改或移除。

📜 开源许可

本项目仅供个人学习研究使用,禁止用于商业及非法用途。

基于 MIT license 许可进行开源。

灵感来源

API 源代码来自 MakcRe/KuGouMusicApi

(为了不破坏原项目的结构和后期更新迭代方便,API未做高度集成.其实是图省事)

Apple Music

YouTube Music

YesPlayMusic

酷狗音乐

🖼️ 截图