An open source, simple and beautiful Kugou third-party client V1.0.0 Beta

MoeKoe Music

An open source, simple and beautiful Kugou third-party client 🌎 GitHub repository | 📦️ Download the installation package | 💬 Visit the blog

Preface

As early as around 10 years ago, when I was using the web version of QQ, I had already started using Kugou Music (and I have been a fan for more than ten years), so all the songs I have collected over the years are on it. Later, I also tried to use NetEase Cloud or QQ Music, and also tried to import Kugou’s playlist, but the results were not satisfactory. Most of the songs I listened to were Japanese comic OPs, and many songs could not be found.

After going round and round, I finally returned to Kugou, but Kugou on the Mac may often not be able to play. Although the interface has no functions, it is still very good. Thanks to the help of netizens, I have been listening to songs on Kugou’s [concept version] (https://t1.kugou.com/d2tBza3CSV2), and it is one of the few music player software on the market that can listen to VIP songs for free. I highly recommend it.

I said on my personal introduction page that I really like listening to music, especially Japanese comic OPs. How can I prove it? (My web version of the playlist was also in disrepair before.) Then develop a music player yourself.

✨ Features

• ✅ Developed using Vue.js Family Bucket
• 🔴 Kugou account login (scan code/mobile phone/account login)
• 📃 Support lyrics display
• 📻 Daily recommended songs
• 🚫🤝 No social functions
• 🔗 Direct connection to the official server, no third-party API
• ✔️ Automatically receive VIP every day, log in to become VIP
• 🎨 theme color switching
• 👋 Start greeting
• ⚙️ Multi-platform support
• 🛠 More features are being developed

Todo List

• [ ] 📺Support MV playback
• [ ] 🌚 Light/Dark Mode automatic switching
• [ ] 👆 Support Touch Bar
• [ ] 🖥️ Supports PWA, click ➕ on the right side of the address bar in Chrome/Edge to install it on your computer
• [ ] 🟥 Support Last.fm Scrobble
• [ ] 🎧 Support Mpris
• [ ] ⌨️ Custom shortcut keys and global shortcut keys
• [ ] 🤟 Multi-language support
• [ ] 📻 Desktop Lyrics
• [ ] ⚙️ System architecture optimization
• [ ] 🎶Songs, Playlists/Favorites, Cancel

📦️ Installation

Visit the Releases page of this project to download the installation package.

⚙️ Development

1. Clone the repository

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

2. Enter the directory and install dependencies

cd MoeKoeMusic
npm install

3. Start developer mode

   npm rundev
   

4. Package project

   npm run build
   

5. Compile the project

   • Windows:

     npm run electron:build:win [default NSIS installation package]
     

   • Linux:

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

   • macOS:

     npm run electron:build:macos [default Apple Silicon architecture]
     

For more commands, please view the package.json file scripts

👷‍♂️ Compile client

If you do not find the installation package suitable for your device on the Release page, you can package your own client according to the following steps.

1. Install Node.js and make sure the Node.js version is >= 18.0.0.

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

3. Use npm install to install project dependencies.

4. Compile API server

   • Windows:

     npm run build:api:win
     

   • Linux:

     npm run build:api:linux
     

   • macOS:

     npm run build:api:macos
     

5. Select the following command to package the installation package suitable for you. The packaged files are in the /dist_electron directory. For more information, visit electron-builder documentation

1. Package macOS platform

• Universal macOS package (Intel and Apple Silicon dual architecture):

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

• Intel architecture only:

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

• Apple Silicon architecture only:

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

2. Packaging for Windows platform

• Default NSIS installation package (suitable for most Windows users):

  npm run electron:build -- --win
  

• Create EXE file and Squirrel installation package for Windows:

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

  • --ia32 for 32-bit Windows architecture.
  • --x64 for 64-bit Windows architecture.
  • --arm64 is ARM Windows architecture (Surface and other devices).

• Generate portable EXE files for Windows (no installation required):

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

  3. Package Linux platform

• Default AppImage format (works on most Linux distributions):

  npm run electron:build -- --linux
  

• snap (for Ubuntu and snap-enabled 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. Packaged for all platforms

If you need to generate installation packages for Windows, macOS, and Linux at the same time, you can use the following command:

  npm run electron:build -- -mwl

5. Customize compilation settings

You can add additional options to further customize the packaging as needed, such as specifying x64 and arm64 architectures, or selecting a different target format.

☑️ Feedback

If you have any questions or suggestions, please submit an issue or pull request.

Disclaimer

0. This program is a third-party client of Kugou, not Kugou official. If you need more complete functions, please download the official client to experience it.

1. This project is for learning purposes only. Please respect the copyright. Please do not use this project for commercial activities or illegal purposes!

2. Copyright data may be generated during the use of this project. This project does not own the ownership of these copyrighted data. In order to avoid infringement, users must clear the copyright data generated during the use of this project within 24 hours. 3. The user is responsible for any direct, indirect, special, incidental or consequential damages of any nature arising from the use of this project (including but not limited to damages caused by loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses) arising from this agreement or the use or inability to use this project.

3. It is prohibited to use this project in violation of local laws and regulations. The user shall be responsible for any illegal behavior caused by the user knowingly or not knowing that local laws and regulations do not allow the use of this project, and this project does not assume any direct, indirect, special, incidental or consequential liability resulting therefrom.

4. Music platforms are not easy, please respect copyright and support genuine ones.

5. This project is only used for the exploration and research of technical feasibility and does not accept any commercial (including but not limited to advertising, etc.) cooperation and donations.

6. If the official music platform feels that this project is inappropriate, you can contact this project to change or remove it.

📜 Open Source License

This project is for personal study and research only, commercial and illegal purposes are prohibited.

Open source under the MIT license license.

Source of inspiration

The API source code comes from MakcRe/KuGouMusicApi (In order not to destroy the structure of the original project and to facilitate later updates and iterations, the API is not highly integrated. In fact, it saves trouble)

• Apple Music
• YouTube Music
• YesPlayMusic
• Kugou Music

🖼️ Screenshot