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

高板惠乃果

[GitHub仓库](https://github.com/iAJue/MoeKoeMusic)
[下载安装包](https://github.com/iAJue/MoeKoeMusic/releases)
[访问博客](https://MoeJue.cn)

## 截图




## 特性

- 使用 Vue.js 全家桶开发
- 酷狗账号登录（扫码/手机/账号登录）
- 支持歌词显示
- 每日推荐歌曲
- 无任何社交功能
- 官方服务器直连, 无任何第三方 API
- 每日自动领取VIP, 登录就是VIP
- 主题色切换
- 启动问候语
- 多平台支持
- 更多特性开发中

## Todo List
- [ ] 支持 MV 播放
- [ ] Light/Dark Mode 自动切换
- [ ] 支持 Touch Bar
- [ ] 支持 PWA，可在 Chrome/Edge 里点击地址栏右边的 ➕ 安装到电脑
- [ ] 支持 Last.fm Scrobble
- [ ] 支持 Mpris
- [ ] 自定义快捷键和全局快捷键
- [ ] 多语言支持
- [ ] 桌面歌词
- [ ] 系统架构优化
- [ ] 歌曲、歌单/收藏、取消


## 安装

访问本项目的 [Releases](https://github.com/iAJue/MoeKoeMusic/releases) 页面下载安装包。

## 开发

1. 克隆本仓库

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

2. 进入目录并安装依赖

```sh
cd MoeKoeMusic
npm run install-all
```
3. 启动开发者模式
```sh
npm run dev
```
4. 打包项目
```sh
npm run build
```
5. 编译项目
  - Windows:
  ```sh
  npm run electron:build:win [默认 NSIS 安装包]
  ```
  -        Linux:
  ```sh
  npm run electron:build:linux [默认 AppImage 格式]
  ```
  -        macOS:
  ```sh
  npm run electron:build:macos [默认Apple Silicon架构]
  ```


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

## 编译客户端

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

1. 安装 [Node.js](https://nodejs.org/en/)，并确保 `Node.js` 版本 >= 18.0.0。

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

3. 使用 `npm install` 安装项目依赖。
4. 编译API服务端
   - Windows:
  ```sh
  npm run build:api:win
  ```
   - Linux:
  ```sh
  npm run build:api:linux
  ```
   - macOS:
  ```sh
  npm run build:api:macos
  ```

5. 选择下列的命令来打包适合的你的安装包，打包出来的文件在 `/dist_electron` 目录下。了解更多信息可访问 [electron-builder 文档](https://www.electron.build/cli)


#### 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。

## 开源许可

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

基于 [MIT license](https://opensource.org/licenses/MIT) 许可进行开源。

## 灵感来源

API 源代码来自 [MakcRe/KuGouMusicApi](https://github.com/MakcRe/KuGouMusicApi)
(为了不破坏原项目的结构和后期更新迭代方便,API未做高度集成.~~其实是图省事~~)

- [Apple Music](https://music.apple.com)
- [有图比 Music](https://music.有图比.com)
- [YesPlayMusic](https://github.com/qier222/YesPlayMusic)
- [酷狗音乐](https://kugou.com/)

yoxp

loc论坛编辑器没有markdown

高板惠乃果

yoxp 发表于 2024-11-4 18:35
loc论坛编辑器没有markdown

被拦截了,发布出来,在编辑中

欧阳的阳

二次元眼中的高颜值

cherbim

打倒二次元！！！！！！

wcn

有些歌会播放失败，是因为没登录的原因吗？

高板惠乃果

wcn 发表于 2024-11-4 18:54
有些歌会播放失败，是因为没登录的原因吗？

有些是VIP歌曲,要登录一下,之后会把试听加上

wcn

高板惠乃果 发表于 2024-11-4 18:00
有些是VIP歌曲,要登录一下,之后会把试听加上

登录不了，获取手机验证码后点击登录，提示错误

高板惠乃果

wcn 发表于 2024-11-4 19:02
登录不了，获取手机验证码后点击登录，提示错误