guohuiyuan/go-music-dl

これは何？

主な機能

• 01複数のサービスを横断して、単曲、プレイリスト、アルバムをまとめて検索
• 02Web、ターミナルUI、デスクトップ／モバイルアプリの各モードを提供
• 03CookieやQRコードによるログインに対応し、個人用プレイリストや高音質の音声を利用可能
• 04メタデータ、カバー画像、歌詞を読み取り、ローカルの音楽を管理
• 05FFmpegが利用可能な場合、ダウンロードしたファイルにカバー画像や歌詞を埋め込み
• 06ダウンロードしたファイルをWebDAVに同期

ユースケース

• 利用中の音楽配信サービスで見つからない楽曲を探してダウンロードする
• タグや歌詞付きのファイルでローカルの音楽ライブラリを構築する
• Dockerを使い、自宅サーバーで音楽検索・ダウンロードページをセルフホスティングする
• ターミナルから各サービスのランキングやプレイリストを閲覧する

クイックスタート

1. 1

   Releases からデスクトップアプリをダウンロード

2. 2

   Web インターフェースを起動

   ./music-dl web
3. 3

   またはターミナルから検索

   ./music-dl -k "周杰伦"
4. 4

   または Docker で起動

   docker compose up -d --pull always --remove-orphans

使う前に知っておきたいこと

• !AGPL-3.0 ライセンスのため、派生するネットワークサービスはソースコードを公開する必要があります。
• !一部のプラットフォームでは、高音質版、プレイリスト、メンバー限定トラックの利用に Cookies またはログインが必要です。
• !一部のプラットフォーム（例：Apple Music のダウンロード、千千（Qianqian）のプレイリスト検索）の検索結果は不安定または不完全です。
• !メタデータとカバー画像の機能を使うには、Desktop、iOS、CLI の各ビルドで FFmpeg を手動でインストールする必要があります。

トピック

よくある質問

go-music-dl とは？

Web、ターミナルUI、デスクトップアプリから10以上の国内外の音楽配信サービスを検索・ダウンロードできるGoツール。 Go Music DLは、NetEase Cloud Music、QQ Music、Kugou、Kuwo、Migu、Bilibili、Apple Music、JOOXなど、複数の音楽配信サービスで楽曲、プレイリスト、アルバム、ランキングを検索できます。複数のサービスをまとめて検索したり、楽曲をプレビューしたり、一括ダウンロードしたりできるほか、元のサービスで楽曲を入手できない場合は、別の配信元に切り替えられます。

go-music-dl は無料で使えますか？ライセンスは？

go-music-dl は AGPL-3.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

go-music-dl は今もメンテナンスされていますか？

活発にメンテナンス中。go-music-dl の最終コミットは 2026年10月19日 です。

go-music-dl は何に使えますか？

利用中の音楽配信サービスで見つからない楽曲を探してダウンロードする タグや歌詞付きのファイルでローカルの音楽ライブラリを構築する Dockerを使い、自宅サーバーで音楽検索・ダウンロードページをセルフホスティングする ターミナルから各サービスのランキングやプレイリストを閲覧する

go-music-dl のインストール方法は？

Releases からデスクトップアプリをダウンロード Web インターフェースを起動: ./music-dl web またはターミナルから検索: ./music-dl -k "周杰伦" または Docker で起動: docker compose up -d --pull always --remove-orphans

go-music-dl はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/guohuiyuan/go-music-dl