MoeKoeMusic /MoeKoeMusic

一款开源简洁高颜值的酷狗第三方客户端 An open-source, concise, and aesthetically pleasing third-party client for KuGou that supports Windows / macOS / Linux / Web :electron:

★ 7,185⑂ 454👁 19⑃ 114● 1,030▤ 73
VueGPL-2.0Created 2024-11-02Music.MoeKoe.cn
下载:Release v1.7.2 Hotfix 2Release-1.7.2 ↓1.7.22026-11-08
+9
日增长
7,185
stars
454
forks
19
watchers
114
prs
1,030
issues
73
releases

README

MoeKoe Music
  
    
    
    
    
    
  
  
    一款开源简洁高颜值的酷狗第三方客户端
    
    🌎 GitHub仓库  |  
    📦️ 下载安装包  |  
    💬 访问博客  |  
    🏠 项目主页
  
  
    🇨🇳 简体中文  |  
    🇨🇳 繁体中文  |  
    🇯🇵 日本語  |  
    🇺🇸 English  |  
    🇰🇷 한국어  |  
    🇷🇺 Русский
    
    
  


!images

 ❤️ 前言

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

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

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


 ✨ 特性

- ✅ 使用 Vue.js 全家桶开发
- 🔴 酷狗账号登录(扫码/手机/账号登录)
- 📃 支持歌词显示
- 📻 每日推荐歌曲
- 🔕 无任何社交功能
- 🔗 官方服务器直连
- ✔️ 每日自动领取VIP,登录就是VIP
- 🎨 主题色切换
- 👋 启动问候语
- ⚙️ 多平台支持
- 🧩 超级插件系统
- 🧭 布局个性化设置
- 🥚 隐藏功能与彩蛋系统
- 🚀 新手引导系统
- ✨ 更多特性由你来探索

 📢 Todo List
- [x] 📺 支持 MV 播放
- [x] 🌚 Light/Dark Mode 自动切换
- [x] 👆 支持 Touch Bar
- [x] 🖥️ 支持 PWA
- [x] ⌨️ 全局快捷键
- [x] 🤟 多语言支持
- [x] 📻 桌面歌词
- [x] ⚙️ 系统架构优化
- [x] 🎶 歌曲、歌单/收藏、取消

查看更新日志

 📦️ 安装

 1. 客户端安装

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

 2. WEB端安装(docker)

 注意:部署后请开放服务器对应端口才可使用,或者使用反向代理实现域名访问。

    1. 方式一:快速启动(推荐)

    
    git clone --depth=1 https://github.com/MoeKoeMusic/MoeKoeMusic.git
    cd MoeKoeMusic
    docker compose up -d &
    

    2. ~~方式二:使用docker-compose一键安装 (镜像暂未上传官方)~~
    
    
    docker run -d --name MoeKoeMusic -p 8080:8080 -e PORT=6521 -e platform=lite iajue/moekoe-music:latest
    

    3. 方式三:宝塔容器编排

     远程镜像,版本可能会落后于官方
    
    
    version: '3.3'
    
    services:
      moekoe-music:
         镜像地址
        image: registry.cn-wulanchabu.aliyuncs.com/youngxj/moekoe-music:latest
        container_name: moekoe-music  容器名
        restart: unless-stopped  自动重启
        build:
          context: .
          dockerfile: Dockerfile
        environment:
          - PORT=6521
          - platform=lite
        ports:  端口映射
          - "8080:8080"   前端服务
          - "6521:6521"   接口服务
    
    
    
    复制内容上面的内容,粘贴到宝塔面板的容器编排里面,编排名称为MoeKoeMusic,点击部署即可。

 3. 一键部署


需在环境变量(VITE_APP_API_URL)中填写自己的API地址

 ⚙️ 开发

1. 克隆本仓库

sh
git clone --depth=1 https://github.com/MoeKoeMusic/MoeKoeMusic.git


2. 进入目录并安装依赖

sh
cd MoeKoeMusic
pnpm install --frozen-lockfile

3. 启动开发者模式
  - 在浏览器里开发
  sh
  pnpm run dev
  
  - 在客户端开发模式下开发
  sh
  pnpm run dev:client
  

4. 构建前端
为你的目标平台选择一条命令来构建前端
sh
pnpm run build  为网页端或客户端构建前端
pnpm run build:docker  为 Docker 镜像构建前端

5. 编译项目
  - Windows: 
sh
pnpm run electron:build:win  [默认 NSIS 安装包]

  - Linux: 
sh
pnpm run electron:build:linux  [默认 AppImage 格式]

  - macOS: 
sh
pnpm run electron:build:macos  [默认 macOS 双架构]



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

 👷‍♂️ 编译客户端

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

1. 安装 Node.js,并确保 Node.js 版本 = 24。

2. 使用 git clone --depth=1 https://github.com/MoeKoeMusic/MoeKoeMusic.git 克隆本仓库到本地。

3. 使用 pnpm install --frozen-lockfile 安装项目依赖。

4. 

Top issues

Discussions

Latest release

Release v1.7.2 Hotfix 2 v1.7.2 2026-11-08
[!IMPORTANT]  
 该版本修改了部分插件接口  
 部分插件可能无法正常使用  
 如果你介意请等待插件开发者适配后再更新到该版本

 [!TIP]  
 如果你是插件开发者可以参阅插件迁移文档

 What's Changed
 feat: realize report and sync listen time by @LateDreamXD in https://github.com/MoeKoeMusic/MoeKoeMusic/pull/1206
 feat: 实现 macOS 关闭窗口后隐藏 Dock 图标 by @No-World in https://github.com/MoeKoeMusic/MoeKoeMusic/pull/1213
 feat(api): built api into electron client by @LateDreamXD in https://github.com/MoeKoeMusic/MoeKoeMusic/pull/1217
 feat(electron/extensions): add apiMode permission to start api service automatically for extensions needs by @LateDreamXD in https://gi

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON