gallery dl
1.27.7
gallery-dl は、いくつかの画像ホスティング サイト (サポートされているサイトを参照) から画像ギャラリーとコレクションをダウンロードするコマンド ライン プログラムです。これは、多くの構成オプションと強力なファイル命名機能を備えたクロスプラットフォーム ツールです。
コンテンツ
依存関係
オプション
インストール
ピップ
スタンドアロン実行可能ファイル
ナイトリービルド
スナップ
チョコレートティ
スクープ
自作
Macポート
ドッカー
使用法
例
構成
ドキュメント
所在地
認証
ユーザー名とパスワード
クッキー
OAuth
Python 3.4+
リクエスト
yt-dlp または youtube-dl: HLS/DASH ビデオのダウンロード、 ytdl統合
FFmpeg: Pixiv Ugoira 変換
mkvmerge: 正確な Ugoira フレーム タイムコード
PySocks: SOCKS プロキシのサポート
Brotli または Brotlicffi: Brotli 圧縮のサポート
zstandard: Zstandard 圧縮のサポート
PyYAML: YAML 設定ファイルのサポート
toml: Python<3.11 の TOML 設定ファイルのサポート
SecretStorage: --cookies-from-browserの GNOME キーリング パスワード
gallery-dlの安定リリースは PyPI で配布されており、pip を使用して簡単にインストールまたはアップグレードできます。
python3 -m pip install -U gallery-dl
最新の開発バージョンを GitHub から直接インストールすることも、pip を使用して行うことができます。
python3 -m pip install -U -I --no-deps --no-cache-dir https://github.com/mikf/gallery-dl/archive/master.tar.gz
注: Windows ユーザーはpython3の代わりにpy -3使用する必要があります。
必須パッケージsetuptoolsとwheelを含む pip の最新バージョンを使用することをお勧めします。これらのパッケージが最新であることを確認するには、次のコマンドを実行します。
python3 -m pip install --upgrade pip setuptools ホイール
Python インタープリターと必要な Python パッケージを含む事前に構築された実行可能ファイルは、
Windows (Microsoft Visual C++ 再頒布可能パッケージ (x86) が必要)
Linux
最新のコミットからビルドされた実行可能ファイルは、次の場所にあります。
https://github.com/gdl-org/builds/releases
Snapd でサポートされているディストリビューションを使用している Linux ユーザーは、Snap Store からgallery-dl をインストールできます。
スナップインストールギャラリー-DL
Chocolatey がインストールされている Windows ユーザーは、Chocolatey コミュニティ パッケージ リポジトリからgallery-dl をインストールできます。
choco ギャラリー DL をインストールします
gallery-dlは、Windows ユーザー向けの Scoop の「メイン」バケットでも利用できます。
スクープインストールギャラリー-dl
Homebrew を使用している macOS または Linux ユーザーの場合:
brew インストール ギャラリー DL
MacPorts を使用する macOS ユーザーの場合:
sudo ポート インストール ギャラリー DL
リポジトリで Dockerfile を使用する:
git clone https://github.com/mikf/gallery-dl.gitcd gallery-dl/ docker build -t gallery-dl:latest 。
Docker Hub からイメージをプルします。
docker pull mikf123/gallery-dl docker タグ mikf123/gallery-dl gallery-dl
GitHub Container Registry からイメージをプルします。
ドッカープル ghcr.io/mikf/gallery-dl docker タグ ghcr.io/mikf/gallery-dl gallery-dl
コンテナーを実行するには、構成ファイルとダウンロードが実行後も持続できるように、ホスト上にいくつかのディレクトリを接続する必要があるでしょう。
必ず、リポジトリ内のサンプル構成ファイルのリファレンスをダウンロードしてマウントされたボリュームの場所に配置するか、そこにある空のファイルをタッチしてください。
コンテナに別のタグを付けた場合、または podman を使用している場合は、必ず調整してください。 名前がわからない場合は、 docker image ls実行して名前を確認します。
これにより、使用するたびにコンテナーが削除されるため、常に新しい環境で実行できるようになります。コンテナを自動構築するように ci-cd パイプラインを設定する場合は、 --pull=newerフラグを追加することもできます。これにより、コンテナの実行時に Docker が新しいコンテナがあるかどうかを確認し、実行前にダウンロードします。
docker run --rm -v $HOME/Downloads/:/gallery-dl/ -v $HOME/.config/gallery-dl/gallery-dl.conf:/etc/gallery-dl.conf -it gallery-dl:最新
「gallery-dl」のエイリアスをシェルに追加したり、単純な bash スクリプトを作成して $PATH のどこかにドロップして、このコマンドの shim として機能させることもできます。
gallery-dl を使用するには、画像をダウンロードしたい URL を指定してこれを呼び出すだけです。
gallery-dl [オプション]... URL...
すべてのコマンドライン オプションの完全なリストについては、 gallery-dl --helpを使用するか、docs/options.md を参照してください。
画像をダウンロードします。この場合、danbooru から「bonocho」のタグ検索を使用します。
gallery-dl "https://danbooru.donmai.us/posts?tags=bonocho"
ユーザー名とパスワードによる認証をサポートするサイトから画像の直接 URL を取得します。
gallery-dl -g -u "<ユーザー名>" -p "<パスワード>" "https://twitter.com/i/web/status/604341487988576256"
マンガの章を章番号と言語でフィルタリングします。
gallery-dl --chapter-filter "10 <= 章 < 20" -o "lang=fr" "https://mangadex.org/title/59793dd0-a2d8-41a2-9758-8197287a8539"
リモート リソースで URL を検索し、そこから画像をダウンロードします。
(エクストラクタが見つからない URL は黙って無視されます)
gallery-dl "r:https://pastebin.com/raw/FLwrCYsT"
サイトのアドレスがエクストラクターの標準ではない場合は、URL にエクストラクターの名前をプレフィックスとして付けて、特定のエクストラクターの使用を強制できます。
gallery-dl "tumblr:https://sometumblrblog.example"
gallery-dlの構成ファイルは、JSON ベースのファイル形式を使用します。
利用可能なすべての構成オプションのリストとその説明は、https://gdl-org.github.io/docs/configuration.html にあります。
使用可能なオプションがデフォルト値に設定されているデフォルト構成ファイルについては、docs/gallery-dl.conf を参照してください。
より複雑な設定とオプションの使用法を含むコメント付きの例については、docs/gallery-dl-example.conf を参照してください。
gallery-dl は、次の場所で構成ファイルを検索します。
Windows:
( %USERPROFILE%は通常、ユーザーのホーム ディレクトリ、つまりC:Users<username>を指します)
%APPDATA%gallery-dlconfig.json
%USERPROFILE%gallery-dlconfig.json
%USERPROFILE%gallery-dl.conf
Linux、macOS など:
/etc/gallery-dl.conf
${XDG_CONFIG_HOME}/gallery-dl/config.json
${HOME}/.config/gallery-dl/config.json
${HOME}/.gallery-dl.conf
実行可能ファイルとして実行すると、 gallery-dl は、実行可能ファイルと同じディレクトリでgallery-dl.confファイルも検索します。
一度に複数の構成ファイルを使用することができます。この場合、最初のファイル以降のファイルの値は、すでにロードされている設定にマージされ、以前の設定がオーバーライドされる可能性があります。
一部のエクストラクターでは、ユーザー名とパスワードのペアの形式で有効なログイン資格情報を提供する必要があります。 nijieでは必須ですが、 aryion 、 danbooru 、 e621 、 exhentai 、 idolcomplex 、 imgbb 、 inkbunny 、 mangadex 、 mangoxo 、 pillowfort 、 sankaku 、 subscribestar 、 tapas 、 tsumino 、 twitter 、 zerochanではオプションです。
必要な情報を設定ファイルに設定できます
{ "抽出者": { "twitter": { "ユーザー名": "<ユーザー名>"、"パスワード": "<パスワード>"
}
}
}または、 -u/--usernameと-p/--passwordまたは-o/--optionコマンドライン オプションを介して直接指定することもできます。
gallery-dl -u "<ユーザー名>" -p "<パスワード>" "URL"gallery-dl -o "ユーザー名=<ユーザー名>" -o "パスワード=<パスワード>" "URL"
CAPTCHA などによりユーザー名とパスワードでログインできないサイト、またはまだ実装されていないサイトの場合は、ブラウザのログイン セッションから Cookie を使用してgallery-dlに入力できます。
これは、設定ファイルの cookie オプションで次のように指定することで実行できます。
ブラウザ アドオンによってエクスポートされた Mozilla/Netscape 形式の cookies.txt ファイルへのパス
(例: Chrome の場合は cookies.txt をローカルで取得、Firefox の場合は Cookie をエクスポート)
ブラウザの Web 開発者ツールから収集された名前と値のペアのリスト
(Chrome の場合、Firefox の場合)
Cookie を抽出するブラウザの名前
(対応ブラウザはChromiumベース、Firefox、Safariです)
例えば：
{ "エクストラクター": { "インスタグラム": { "クッキー": "$HOME/path/to/cookies.txt"
}, "patreon": { "cookie": { "session_id": "K1T57EKu19TR49C51CDjOJoXNQLF7VbdVOiBrC9ye0a"
}
}, "twitter": { "cookie": ["firefox"]
}
}
} --cookiesコマンドライン オプションを使用して cookies.txt ファイルを指定することもできます。
または--cookies-from-browserを使用して Cookie を抽出するブラウザ:
gallery-dl --cookies "$HOME/path/to/cookies.txt" "URL"gallery-dl --cookies-from-browser Firefox "URL"
gallery-dl は、一部のエクストラクターに対して OAuth 経由のユーザー認証をサポートしています。これはpixivでは必要ですが、 deviantart 、 flickr 、 reddit 、 smugmug 、 tumblr 、およびmastodonインスタンスではオプションです。
アカウントをgallery-dlにリンクすると、アカウントに代わってリクエストを発行できるようになり、一般ユーザーがアクセスできないリソースにアクセスできるようになります。
これを行うには、まずoauth:<sitename>を引数として呼び出します。例えば：
gallery-dl oauth:flickr
サイトの認証ページに送信され、 gallery-dlへの読み取りアクセスを許可するように求められます。これを承認すると、構成ファイルに追加する必要がある 1 つ以上の「トークン」が表示されます。
mastodonインスタンスで認証するには、引数としてoauth:mastodon:<instance>を指定してgallery-dl を実行します。例えば：
gallery-dl oauth:mastodon:pawoo.net gallery-dl oauth:マストドン:https://mastodon.social/
