Open source, simple, high颜值,酷狗第三方客户端V1.0.0 Beta

admin

The text has been successfully translated into English as follows:
"This post was last edited by Kaibara Hinoju on November 4th, 2024."  



[GitHub repository](https://github.com/iAJue/MoeKoeMusic)
[Download installation package](https://github.com/iAJue/MoeKoeMusic/releases)
[Visit the blog](https://MoeJue.cn)

## Screenshots
## Features
- Developed with Vue全家桶
- Login with Kugou account (scan / phone number / account login)
- Supports lyrics display
- Daily recommended songs
- No social function
- Direct connection to official server, no third-party APIs
- Automatically receive VIP every day, login is VIP
- Theme color switch
- Starting greeting message
- Supports multiple platforms
- More features under development

## Todo list
- [ ] Support playing of MVs
- [ ] Automatic theme color switching
- [ ] Support touch bar
- [ ] Support PWA, installed in Chrome/Edge via right click address bar ➕
- [ ] Support Last.FM Scrobbling
- [ ] Support MPRIS
- [ ] Customize keyboard shortcuts and global shortcuts
- [ ] Multilingual support
- [ ] Desktop lyrics
- [ ] System architecture optimization
- [ ] Song, playlist, collection, cancel


## Installation
Access the project's [Releases](https://github.com/iAJue/MoeKoeMusic/releases) page to download an installation package.
## Development
1. Clone this repository

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

2. Enter the directory and install dependencies

```sh
cd MoeKoeMusic
npm install all
```

3. Start the developer mode

```sh
npm run dev
```

4. Build the project

```sh
npm run build
```

5. Compile the project

- Windows:

```sh
npm run electron:build:win [default NSIS installer]
```

- Linux:

```sh
npm run electron:build:linux [default AppImage format]
```

- macOS:

```sh
npm run electron:build:macos [defaultApple Silicon architecture]
```


More commands can be found in `package.json` file `scripts`.


## Compile client

If you don't find any suitable installation packages for your device on the release page, you can follow these steps to compile your own client.

1. Install Node.js version >= 18.0.0 and ensure it is cloned to local directory.

2. Use `git clone https://github.com/iAJue/MoeKoeMusic.git` to clone this repository locally.

3. Install all dependencies using npm.

4. Compile the API service endpoint

Windows:

```sh
npm run build:api:win
```

Linux:

```sh
npm run build:api:linux
```

MacOS:

```sh
npm run build:api:macos
```


5. Choose the following command to pack the appropriate installation package, which will be saved in `/dist_electron` directory.


#### 1. Pack macOS platform

Windows:

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

Linux:

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

MacOS:

```
npm run electron:build -- --mac --arm64 --target squirrel
```


#### 2. Pack Windows platform

Default NSIS installer for most Windows users:

```
npm run electron:build -- --win
```

For Windows, generate EXE files and Squirrel installer:

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

MacOS:

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

#### 3. Pack Linux platform

Default AppImage format for most Linux distributions:

```
npm run electron:build -- --linux
```

Snap (for Ubuntu and supported distributions):

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

Deb (for Debian/Ubuntu series):

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

Rpm (for Red Hat/Fedora series):

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

#### 4. Pack all platforms

If you need to simultaneously generate Windows, macOS, and Linux installation packages, use the following command:

```
npm run electron:build -- -mwl
```

#### 5. Customize compilation settings

Additional options can be added to further customize compilation, such as specifying x64 and arm64 architectures or selecting different target formats.