Logo

MoeKoe Music

オープンソースでシンプル、見た目も美しいKuGouのサードパーティクライアント
🌎 GitHubリポジトリ | 📦️ インストーラーをダウンロード | 💬 ブログを訪問

images

はじめに

10年ほど前、ウェブ版QQを使っていた頃からKuGou Musicを使い始めました（もう10年来のファンです）。なので、この数年で集めた曲はすべてそこにあります。その後、NetEase Cloud MusicやQQ Musicも試してみましたが、KuGouのプレイリストをインポートしようとしても、結果は芳しくありませんでした。私が聴くのは主に日本のアニメのOPで、多くの曲が見つかりませんでした。

結局、KuGouに戻ってきました。しかし、Mac版のKuGouは時々再生できないことがありました。インターフェースはシンプルですが、それはそれで良い点です。ネットユーザーの勧めで、今はKuGouのコンセプト版で音楽を聴いています。これは市場で数少ない、VIP曲を無料で聴ける音楽プレイヤーで、強くお勧めします。

私の自己紹介ページで、特に日本のアニメのOPを聴くのが大好きだと書きました。それをどう証明するか？（以前のウェブ版プレイリストも長年放置されていました）そうだ、自分で音楽プレイヤーを開発しよう、と。

✨ 特徴

  • ✅ Vue.js ファミリーを使用して開発
  • 🔴 KuGouアカウントでのログイン（QRコード/携帯電話/アカウントでのログイン）
  • 📃 歌詞表示をサポート
  • 📻 毎日のおすすめ曲
  • 🚫🤝 ソーシャル機能一切なし
  • 🔗 公式サーバーに直接接続、サードパーティAPIは一切使用しません
  • ✔️ 毎日VIPを自動で受け取り、ログインするだけでVIPに
  • 🎨 テーマカラーの切り替え
  • 👋 起動時の挨拶メッセージ
  • ⚙️ マルチプラットフォーム対応
  • 🛠 さらに多くの機能を開発中

Todo List

  • [ ] 📺 MV再生をサポート
  • [ ] 🌚 Light/Dark Modeの自動切り替え
  • [ ] 👆 Touch Barをサポート
  • [ ] 🖥️ PWAをサポート、Chrome/Edgeのアドレスバー右側の ➕ をクリックしてPCにインストール可能
  • [ ] 🟥 Last.fm Scrobbleをサポート
  • [ ] 🎧 Mprisをサポート
  • [ ] ⌨️ カスタムショートカットキーとグローバルショートカットキー
  • [ ] 🤟 多言語対応
  • [ ] 📻 デスクトップ歌詞
  • [ ] ⚙️ システムアーキテクチャの最適化
  • [ ] 🎶 曲、プレイリスト/お気に入り、削除

📦️ インストール

本プロジェクトの Releases ページにアクセスしてインストーラーをダウンロードしてください。

⚙️ 開発

  1. このリポジトリをクローンします
git clone https://github.com/iAJue/MoeKoeMusic.git
  1. ディレクトリに移動し、依存関係をインストールします
cd MoeKoeMusic
npm install

  1. 開発者モードで起動します

    npm run dev

  2. プロジェクトをパッケージ化します

    npm run build

  3. プロジェクトをビルドします

    • 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 を参照してください

👷‍♂️ クライアントのビルド

Releaseページにお使いのデバイスに適したインストーラーが見つからない場合は、以下の手順で独自のクライアントをビルドできます。

  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 をお気軽に送信してください。

免責事項

  1. 本プログラムはKuGouのサードパーティクライアントであり、KuGou公式ではありません。より完全な機能が必要な場合は、公式クライアントをダウンロードして体験してください。

  2. 本プロジェクトは学習目的でのみ提供されています。著作権を尊重し、本プロジェクトを商業行為や違法な用途に利用しないでください！

  3. 本プロジェクトの使用中に著作権で保護されたデータが生成される可能性があります。これらのデータについて、本プロジェクトはその所有権を有しません。権利侵害を避けるため、ユーザーは本プロジェクトの使用中に生成された著作権データを24時間以内に削除しなければなりません。

  4. 本プロジェクトの使用に起因する、または本契約、本プロジェクトの使用または使用不能に起因する、いかなる性質の直接的、間接的、特別、偶発的、または結果的な損害（営業権の喪失、業務停止、コンピュータの故障または不具合による損害賠償、その他すべての商業的損害または損失を含むがこれらに限定されない）についても、ユーザーが責任を負うものとします。

  5. 現地の法律や規制に違反して本プロジェクトを使用することは禁止されています。ユーザーが、現地の法律で許可されていないことを知りながら、または知らずに使用したことによって生じたいかなる違法行為についても、ユーザーが責任を負うものとし、本プロジェクトはそれによって生じるいかなる直接的、間接的、特別、偶発的、または結果的な責任も負いません。

  6. 音楽プラットフォームの運営は容易ではありません。著作権を尊重し、正規品を支持してください。

  7. 本プロジェクトは技術的な実現可能性の探求と研究のみを目的としており、いかなる商業的（広告等を含むがこれに限定されない）協力や寄付も受け付けていません。

  8. 公式の音楽プラットフォームが本プロジェクトを不適切と判断した場合は、本プロジェクトに連絡して変更または削除を要請することができます。

📜 ライセンス

本プロジェクトは個人の学習研究目的でのみ使用でき、商業的および違法な用途での使用は禁止されています。

MIT license に基づいてオープンソース化されています。

インスピレーション

APIのソースコードは MakcRe/KuGouMusicApi に由来します（元のプロジェクトの構造を壊さず、将来のアップデートを容易にするため、APIは密結合されていません。正直に言うと、手間を省きたかっただけです）。

🖼️ スクリーンショット

image image image image image image