Ghost-Downloader-3 — 複数プロトコルに対応したクロスプラットフォームダウンローダー
XiaoYouChR/Ghost-Downloader-3
★ 12,819 ・ Python ・ GPL-3.0
概要
Ghost-Downloader-3 は、Web上のさまざまなリソースを一括して管理・取得することを目的としたオープンソースのダウンローダーです。元々は動画クリエイターのリソース管理を支援する個人プロジェクトとして開発が開始されましたが、現在ではWindows、macOS、Linux、Androidの4つのプラットフォームに対応する高機能なダウンロードマネージャーへと発展しています。
Webブラウザ標準のダウンロード機能では対応が難しい分割ダウンロードや、各種ストリーミング動画、BitTorrent(Magnetリンク)、FTP、eD2kといったプロトコルを単一のツールで扱いたい開発者やパワーユーザーに向いています。また、GUIによる操作だけでなく、専用のコマンドラインツール(CLI)やaria2互換のRPC APIも提供されているため、外部ツールとの連携やスクリプトからの自動化を行いたい環境にも適しています。
主な特徴
-
幅広いダウンロードプロトコルと配信形式のサポート
標準的なHTTP/HTTPSはもちろん、Magnet/BitTorrent、FTP、eD2kのほか、動画配信で広く用いられるM3U8やMPEG-DASHといったストリーミング形式のダウンロードに対応しています。 -
主要プラットフォームへのクロスプラットフォーム展開
デスクトップ環境(Windows 10以降、macOS 13.0以降、Linux)に加え、Android(9.0以降)にも対応しています。Android版ではM3U8ライブストリーミングの録画やバックグラウンドダウンロード機能も利用可能です。 -
動画プラットフォームや開発者向けホスティングへの最適化
YouTubeやBilibiliに対応し、クリップ範囲の選択、解像度や字幕の指定、プレイリストの一括取得が可能です。また、GitHubやHuggingFace向けにはミラー加速機能が用意されています。 -
ブラウザ拡張機能とのシームレスな連携
ブラウザ拡張機能側でWebページ内のメディアリソースを検出し、認証状態を引き継いだままデスクトップアプリ側へダウンロードタスクを渡すことができます。 -
aria2互換のRPC APIおよびダウンロード途中での設定変更
aria2互換のRPCインターフェースを備えており、既存のエコシステムやサードパーティ製ツールから制御できます。さらに、ダウンロード実行中にURLやHTTPヘッダー、プロキシ設定を変更することも可能です。 -
CLIツール
ghdによるターミナル操作
デスクトップアプリの設定画面からコマンドラインツールを導入でき、シェルのスクリプトや端末上からタスクの追加・一覧・一時停止・再開などの操作が可能です。
使い方
CLIツール(ghd)の導入とコマンド一覧
READMEによると、CLIツールである ghd はデスクトップアプリの「Settings -> Command Line Tool」からインストールできます。
導入後に利用できる主なサブコマンドは以下のとおりです。
| コマンド | 説明 |
|---|---|
ghd probe |
タスクを追加せずにURLを事前検証(プレビュー)する |
ghd add ... |
タスクを追加してダウンロードを開始する |
ghd tasks |
登録されているタスクを一覧表示する |
ghd task |
指定したタスクの詳細情報を表示する |
ghd pause ... |
指定したタスクを一時停止する |
ghd start ... |
一時停止中のタスクを再開する |
ghd remove ... |
タスクを削除し、未完了のファイルを削除する |
ghd wait ... |
タスクが完了するまで待機する |
CLIでの実行例
トレントファイルの内容を確認してから、特定のファイルのみを選択してダウンロードする手順は次のように実行します。
# トレントファイルに含まれるファイル一覧を確認
ghd probe "https://example.com/a.torrent"
# インデックス0番と3番のファイルのみを指定し、./downloads ディレクトリに保存
ghd add "https://example.com/a.torrent" --select 0,3 -o ./downloads
# 指定したタスク(例: tsk_0123)の完了を待機
ghd wait tsk_0123
Linux環境での導入(Arch Linux)
Arch Linux向けには、コミュニティ有志によるAURパッケージ(ghost-downloader-bin および ghost-downloader-git)が提供されています。
技術的なポイント
READMEのReferences(参照ライブラリ)やトピックから、本プロジェクトが多数の確立されたオープンソースライブラリを組み合わせて構成されていることがわかります。
- GUIおよびランタイム環境
メインの実装言語はPythonであり、GUIツールキットとしてPySide6(Qt)およびモダンな外観を提供するPyQt-Fluent-Widgetsが採用されています。また、ビルドや配布にはPythonコンパイラであるNuitkaが活用されています。 - 非同期処理基盤
Pythonの標準非同期ライブラリasyncioをベースに、高速なイベントループ実装であるuvloop(Windows向けにはwinloop)を組み合わせて高い並行処理性能を確保しています。 - プロトコル処理・通信ライブラリの統合
- HTTP通信およびブラウザTLSフィンガープリントのエミュレーションには
wreqを使用。 - FTP通信には非同期対応の
aioftpを使用。 - BitTorrent/Magnetの処理にはC++実装の
libtorrentを統合。 - eD2kプロトコルには専用エンジン
Kelpieを採用。 - 動画関連の処理には
yt-dlp、FFmpeg、HLS/DASH処理ツールであるN_m3u8DL-RE、パーサーライブラリ(m3u8、mpegdash)などを組み合わせています。 - そのほか、ブラウザリソース検出の仕組みとして
cat-catchの知見や、組み込みJavaScriptエンジンであるQuickJS-NGが参照されています。
- HTTP通信およびブラウザTLSフィンガープリントのエミュレーションには
注意点
- CPU要件(AVX命令セットの必須化)
Qt 6.6以降の仕様変更に伴い、AVX命令セットに対応していない古いCPU環境では動作しない旨が警告(Warning)として明記されています。 - 対応OSバージョンとアーキテクチャ
各プラットフォームの動作要件は以下のとおりです。- Windows: 10以上(x86_64 / arm64)
- macOS: 13.0以上(x86_64 / arm64)
- Linux: glibc 2.35以上(x86_64 / arm64)
- Android: 9.0以上(arm64-v8a)
- 多言語対応の仕組み
翻訳はCrowdin経由で管理されており、ソース言語は簡体字中国語です。全体の60%以上が翻訳された言語がデスクトップアプリに収録され、未翻訳の部分は英語で表示されます。翻訳に関する変更のPull Requestはリポジトリ上では受け付けていません。 - ライセンス
本プロジェクトは GNU General Public License v3.0(GPL-3.0)の下で公開されています。ソースコードの再配布や改変を行う際は、同ライセンスの条項に従う必要があります。
まとめ
Ghost-Downloader-3 は、Webダウンロードからストリーミング保存、P2P共有プロトコルまでを幅広く網羅する多機能ダウンローダーです。PySide6による洗練されたGUIに加え、CLIツールやaria2互換APIも備えており、日常的なダウンロード管理から自動化スクリプトとの連携まで柔軟に対応できるツールとなっています。





