gallery-dlでRedditをダウンロード：OAuthとエラー対策

gallery-dlでRedditを扱うときは、目的を表す最小のURLから始めます。公開投稿、subreddit、ユーザーページなど、インストール済みの抽出器が認識する種類を選んでください。通常のブラウザーのアドレスバーから正規URLをコピーし、可能なら追跡パラメーターを外して、シェルではURLを引用符で囲みます。短縮URLやモバイルからのリダイレクトは、サポート問題をコマンド問題に見せることがあります。

--simulateはメディアを書き込まずに抽出器と選択対象を確認できる、最初の安全な比較です。インストール、URL認識、アクセス、設定、保存先を分けて確認できます。閲覧権限のある公開URLを使い、範囲やフィルター、アーカイブを追加する前に結果を読みます。

gallery-dl --config-ignore --simulate "https://www.reddit.com/r/SUBREDDIT/"

gallery-dl --simulate "https://www.reddit.com/comments/POST_ID/"

gallery-dl -E "https://www.reddit.com/r/SUBREDDIT/"

gallery-dl -K "https://www.reddit.com/comments/POST_ID/"

公式のsupported-sites資料ではRedditが抽出器として掲載されています。ただし、ドメインが一覧にあることは、すべてのページ、検索、アカウント状態、地域で同じ結果になるという意味ではありません。公開投稿やsubredditは最初の確認に向いていますが、保存済み、パーソナライズされたフィード、非公開コミュニティなどはOAuthが必要になり、取得できるメタデータやアクセス条件も変わります。

対応可否は、URLの種類、インストール済みバージョン、アカウント権限、抽出器の機能を組み合わせて判断します。認識されたドメインでも未対応URLと表示されたら、ファイル名や保存設定を変更する前に、正確なパスを公式の対応表と比較してください。公開テストが成功しても、再公開の許可が得られるわけではありません。

匿名アクセスは、アカウントに紐づくRedditコンテンツの代わりにはなりません。抽出器がOAuthを求める場合は、gallery-dl公式設定ドキュメントにあるアプリケーション認証情報を使い、client secretを秘密にし、明確なuser-agentを設定します。これは自分が管理するアカウントとアプリケーションでローカル環境からアクセスするための設定であり、制限を回避するものではありません。

公開URLの初回テストと認証を分けてください。まず公開URLを認識できることを確認し、その後に最小限のOAuth設定を加えて、対象のアカウントURLを--simulateで試します。失敗したらclient ID、secret、user-agent、アカウント権限、公式の最新情報を一度に1項目ずつ確認します。

{
  "extractor": {
    "reddit": {
      "client-id": "YOUR_CLIENT_ID",
      "client-secret": "YOUR_CLIENT_SECRET",
      "user-agent": "gallery-dl/1.32.9 by YOUR_USERNAME"
    }
  }
}

gallery-dl --simulate "https://www.reddit.com/user/USERNAME/saved/"

gallery-dl --config-ignore --simulate "https://www.reddit.com/r/SUBREDDIT/"

シミュレーションが成功したら、保存先を決め、最初の実行を意図的に小さくします。rangeを使えば、ファイル名、画像品質、動画の扱い、欠落項目、容量を確認してからフィードを広げられます。繰り返しのジョブには同じアーカイブを使います。アーカイブは成功した抽出IDを記録しますが、メディアのバックアップではありません。

コマンドラインで動作を確認してから設定ファイルへ移します。ファイル名やフィルターを作る前に-Kでメタデータを見て、保存先、アーカイブ、アカウント固有の値を公開スニペットに含めないでください。更新後に動作が変わったら、構成を作り直す前にバージョンとクリーンなシミュレーションを比較します。

gallery-dl --range "1-10" --download-archive "reddit.sqlite3" "https://www.reddit.com/r/SUBREDDIT/"

gallery-dl --destination "D:/Media/Reddit" --download-archive "reddit.sqlite3" "https://www.reddit.com/r/SUBREDDIT/"

gallery-dl --write-metadata --download-archive "reddit.sqlite3" "https://www.reddit.com/r/SUBREDDIT/"

Redditの失敗をすべてオプション不足と考えないでください。400は、URLの形式変更、未完成のOAuth、抽出器が現在作れないリクエストで起きることがあります。403やブロックは、権限、レート制限、プラットフォームのポリシー、地域、抽出器の変更が原因かもしれません。再試行を止め、通常のブラウザーでURLを確認し、クリーンなシミュレーションとバージョンを確認します。

空の結果は、厳しいフィルター、すでにIDを含むアーカイブ、削除済みコンテンツ、メディアのないURLでも起こります。同じURLを--config-ignoreかつフィルターなしで比較し、OAuth、range、archive、destination、filterを一つずつ戻してください。こうすれば大きな再試行ループを作らず、失敗した層を特定できます。

gallery-dlはローカルのダウンローダーであり、権限を与える仕組みではありません。アクセスと利用の許可があるコンテンツだけを保存・利用し、Redditのルール、コミュニティ、プライバシー、著作権、アカウント権限、レート制限を尊重してください。URLが技術的に開けても再公開の許可にはなりません。OAuthもアカウント権限を広げません。

このページでは2026年8月10日に、公式PyPIメタデータでgallery-dl 1.32.9を確認し、CodebergのWindows・Linuxリリースファイルを検証しました。抽出器の挙動は変わるため、gallery-dl --versionを実行し、Redditのコマンドが変化したときは公式の対応表と設定資料を再確認してください。

• 最初は公開URLを小さく--simulateで試す
• client secret、token、cookie、非公開URL、未加工ログを共有しない
• 拒否・制限されたendpointへ並列再試行をしない
• 大量処理の前に保存先、フィルター、容量、権限を確認する