gallery-dl 更新方法：安全にバージョンを上げる

よくある失敗は、1つのインストールを更新したのに、ターミナルが別のコピーを起動し続けることです。更新前にバージョンと実行ファイルの場所を記録します。Windows では where gallery-dl、macOS または Linux では which gallery-dl を使います。pip の場合は python -m pip show gallery-dl で、その Python 環境に属するパッケージを確認できます。

この状態を短いメモに残しておくと、更新失敗、PATH の問題、パッケージマネージャーの遅れ、別の単体版を区別できます。バージョンが分からないからといって、設定や Cookie をすぐに削除しないでください。これらは別の切り分け対象です。

gallery-dl --version

where gallery-dl

which gallery-dl

python -m pip show gallery-dl

可能なら、コマンドの所有元を1つに決めます。pip、システムのパッケージ、単体実行ファイルを混在させると、別のコピーを更新しやすくなります。どれか分からない場合は、先に実行ファイルの場所を確認してください。

公式プロジェクトの安定版リリースと単体ファイルは、各パッケージマネージャーとは別のタイミングで公開されます。パッケージマネージャー側が遅れる場合もあれば、単体版が新しくても PATH の後ろのフォルダーにある場合もあります。

公式のコマンドラインオプションには、更新、更新確認、リリースチャンネルの選択があります。実行ファイル自身が更新できる場合には便利ですが、実行パスの確認を省略するものではありません。パッケージマネージャーがファイルを管理している場合は、そのマネージャーを更新元にしてください。

通常の用途では安定版が基本です。別のチャンネルは理由があり、同じ状態を再現できる場合だけ選びます。あとでパッケージマネージャーが意図せず置き換えないよう、選択したチャンネルを記録しておきます。

gallery-dl -U

gallery-dl --update-check

gallery-dl --update-to stable

PATH を変更した場合は、更新後に新しいターミナルを開きます。表示されたパスを、更新前に記録したものと比較してください。Python パッケージと単体版の両方がある場合は、最初のコマンドが更新済みだと決めつけず、それぞれを意図的に確認します。

次に小さな公開 URL をシミュレーションで実行します。新しい extractor が起動し、目的の設定を読み込み、大量のダウンロードが始まらないことを確認できます。

gallery-dl --config-ignore --simulate "URL"

gallery-dl --config-status

バージョンが変わらないときは、まずターミナルが別の実行ファイルを解決していないか確認します。pip が成功してもコマンドが変わらない場合は、python -m pip show gallery-dl とコマンドのパスを比較して、ターミナルを開き直します。パッケージマネージャーが公式の安定版より遅い場合もありますが、それは必ずしも更新の失敗ではありません。

更新後にサイトの挙動が変わった場合は、バージョン、URL の認識、Cookie、設定、レート制限、保存先を分けて確認します。まずクリーンなシミュレーションから始め、Cookie、認証ヘッダー、非公開 URL、完全なローカルパスは報告に含めないでください。

where gallery-dl
gallery-dl --version

gallery-dl --config-ignore --simulate "URL"

• 新しい実行ファイルが小さなテストに成功するまで旧版を残す。
• パスを記録せずにパッケージマネージャーと単体版を混在させない。
• URL や認証方式が変わったら対応サイトの説明を確認する。
• レート制限やアクセス制御はサイトのルールとして扱い、回避しない。