MoeKoe 音樂

一款開源、簡潔、高顏值的酷狗第三方客戶端
🌎 GitHub 儲存庫 | 📦️ 下載安裝包 | 💬 瀏覽部落格

前言

早在約 10 年前，當時我還在使用網頁版 QQ 時就已經開始使用酷狗音樂了（也是十多年的老粉絲了），所以這些年收藏的歌曲全部都在上面。後來我也嘗試開始使用網易雲或 QQ 音樂，也嘗試把酷狗的歌單匯入進去，但是效果都不盡理想。我聽的大多是日漫 OP，好多歌曲都沒辦法找到。

兜兜轉轉最後還是回到酷狗，但是在 Mac 端的酷狗，時常可能會出現不能播放的情況，雖說介面沒什麼功能，但也挺好的。在網友的推薦下，我現在一直是在酷狗的概念版上聽歌，並且是市面上為數不多能免費聽 VIP 歌曲的音樂播放軟體了，強力推薦。

我在我的個人介紹頁面說我特別喜歡聽歌，尤其是日漫 OP。怎麼證明呢？（之前我網頁版歌單也年久失修了）那就自己開發一個音樂播放器。

✨ 特性

• ✅ 使用 Vue.js 全家桶開發
• 🔴 酷狗帳號登入（掃碼/手機/帳號登入）
• 📃 支援歌詞顯示
• 📻 每日推薦歌曲
• 🚫🤝 無任何社交功能
• 🔗 官方伺服器直連，無任何第三方 API
• ✔️ 每日自動領取 VIP，登入即是 VIP
• 🎨 主題色切換
• 👋 啟動問候語
• ⚙️ 多平台支援
• 🛠 更多特性開發中

待辦清單

• [ ] 📺 支援 MV 播放
• [ ] 🌚 自動切換淺色/深色模式
• [ ] 👆 支援 Touch Bar
• [ ] 🖥️ 支援 PWA，可在 Chrome/Edge 中點擊網址列右邊的 ➕ 安裝到電腦
• [ ] 🟥 支援 Last.fm Scrobble
• [ ] 🎧 支援 Mpris
• [ ] ⌨️ 自訂快捷鍵和全域快捷鍵
• [ ] 🤟 多語言支援
• [ ] 📻 桌面歌詞
• [ ] ⚙️ 系統架構優化
• [ ] 🎶 歌曲、歌單管理/收藏、取消收藏

📦️ 安裝

請造訪本專案的 Releases 頁面下載安裝包。

⚙️ 開發

1. 克隆本儲存庫

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

2. 進入目錄並安裝依賴

cd MoeKoeMusic
npm install

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 [預設 Apple Silicon 架構]
     

更多指令請查看 package.json 檔案中的 scripts

👷‍♂️ 編譯客戶端

如果在 Releases 頁面沒有找到適合你裝置的安裝包，你可以根據以下步驟來打包自己的客戶端。

1. 安裝 Node.js，並確保 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 文件

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。

免責聲明

0. 本程式是酷狗第三方客戶端，並非酷狗官方，需要更完善的功能請下載官方客戶端體驗。

1. 本專案僅供學習使用，請尊重版權，請勿利用此專案從事商業行為及非法用途！

2. 使用本專案的過程中可能會產生版權數據。對於這些版權數據，本專案不擁有它們的所有權。為了避免侵權，使用者務必在 24 小時內清除使用本專案的過程中所產生的版權數據。

3. 由於使用本專案產生的，包括由於本協議或由於使用或無法使用本專案而引起的任何性質的任何直接、間接、特殊、偶然或結果性損害（包括但不限於因商譽損失、停工、電腦故障或故障引起的損害賠償，或任何及所有其他商業損害或損失）由使用者負責。

4. 禁止在違反當地法律法規的情況下使用本專案。對於使用者在明知或不知當地法律法規不允許的情況下使用本專案所造成的任何違法違規行為由使用者承擔，本專案不承擔由此造成的任何直接、間接、特殊、偶然或結果性責任。

5. 音樂平台不易，請尊重版權，支持正版。

6. 本專案僅用於對技術可行性的探索及研究，不接受任何商業（包括但不限於廣告等）合作及捐贈。

7. 如果官方音樂平台覺得本專案不妥，可聯繫本專案更改或移除。

📜 開源許可

本專案僅供個人學習研究使用，禁止用於商業及非法用途。

基於 MIT license 許可進行開源。

靈感來源

API 原始碼來自 MakcRe/KuGouMusicApi (為了不破壞原專案的結構和方便後期更新迭代，API 未做高度整合。其實是圖省事)

• Apple Music
• YouTube Music
• YesPlayMusic
• 酷狗音樂

🖼️ 截圖