MoeKoe Music

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

🌎 GitHub仓库  |  
📦️ 下载安装包  |  
💬 访问博客  |  
🏠 项目主页


🇨🇳 简体中文  |  
🇨🇳 繁体中文  |  
🇯🇵 日本語  |  
🇺🇸 English  |  
🇰🇷 한국어

!images (https://github.com/iAJue/MoeKoeMusic/raw/main/images/1.png)

❤️ 前言

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

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

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

✨ 特性

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

📢 Todo List

• 📺 支持 MV 播放
• 🌚 Light/Dark Mode 自动切换
• 👆 支持 Touch Bar
• 🖥️ 支持 PWA，可在 Chrome/Edge 里点击地址栏右边的 ➕ 安装到电脑
• 🟥 支持 Last.fm Scrobble
• 🎧 支持 Mpris
• ⌨️ 全局快捷键
• 🤟 多语言支持
• 📻 桌面歌词
• ⚙️ 系统架构优化
• 🎶 歌曲、歌单/收藏、取消

更新日志请查看 Commits (https://github.com/iAJue/MoeKoeMusic/commits/main/)

📦️ 安装

1. 客户端安装

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

2. WEB端安装（docker）

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

  1. 方式一：快速启动（推荐）

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

  2. 方式二：使用docker-compose一键安装 （镜像暂未上传官方）

  docker run -d --name MoeKoeMusic -p 8080:8080 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
      ports: # 端口映射
        - "8080:8080"  # 前端服务
        - "6521:6521"  # 接口服务
  

  复制内容上面的内容，粘贴到宝塔面板的容器编排里面，编排名称为MoeKoeMusic，点击部署即可。

3. 一键部署

使用 EdgeOne Pages 部署 (https://cdnstatic.tencentcs.com/edgeone/pages/deploy.svg)

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

⚙️ 开发

1. 克隆本仓库

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

2. 进入目录并安装依赖

cd MoeKoeMusic
npm run install-all

3. 启动开发者模式

npm run dev

4. 打包项目

npm run build

5. 编译项目

• Windows:

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

• Linux:

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

• macOS:

npm run electron:build:macos [默认 macOS 双架构]

更多命令请查看 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:

     npm run build:api:win
     

   • Linux:

     npm run build:api:linux
     

   • macOS:

     npm run build:api:macos
     

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