ダウンロードを見つけやすく

gallery-dl ファイル名テンプレート:名前、フォルダー、メタデータ

gallery-dl ファイル名テンプレートを使うと、抽出器のメタデータから規則的なファイル名や保存先を作れます。このページでは、URLごとに使える項目を調べ、短い書式を組み立て、OSで使えない文字を扱い、大量取得の前に結果を確かめる手順を説明します。

メタデータを使った命名整理しやすい保存先安全な事前テスト
ターミナルからメタデータ付きのファイルが整理されたフォルダーへ進む編集イラスト
命名書式は抽出器の項目と、繰り返し使えるローカルのフォルダー構成をつなぎます。
まず -K で調べてから書式を作る

gallery-dl -K "URL" を実行すると、その抽出器が公開する置換キーを確認できます。キーを --filename または extractor.filename の書式に使い、フォルダーには extractor.directory を設定します。恒久設定にする前に --simulate と少量のURLで試してください。ある抽出器のキーが別の抽出器でも使えるとは限りません。

保存結果から考える

gallery-dl のファイル名テンプレートでできること

ファイル名テンプレートは、gallery-dl がファイルを準備するときに評価する書式文字列です。抽出器が提供する ID、タイトル、日付、作者、ページ番号、拡張子などのメタデータと、読みやすい区切りを組み合わせられます。フォルダーも同じ考え方で作成でき、サイト、作者、シリーズなどの値を階層にできます。

テンプレートが変えるのはローカルでの整理方法です。URLや取得対象の判定は変わりません。最初は短く、識別しやすく、実行するすべてのPCで扱える形式にしましょう。項目を詰め込むより、重複を避けて後から探せる名前にする方が実用的です。

利用できる項目を確認

-K で置換キーとサンプル値を調べる

公式設定ドキュメントでは、対象URLに対する -K または --list-keywords の利用が案内されています。実行すると、ディレクトリー用とファイル名用のキーワード、そのサンプル値が表示されます。この出力がテンプレートの境界です。別サイトの例、古い記事、推測した変数ではなく、対象抽出器が何を提供するかを基準にしてください。

アクセスを許可された公開URLを選び、初回の確認は小さく行います。ログインが必要な場合は、サイトの通常のサインイン方法とローカルブラウザーCookieで別に解決します。Cookieや非公開トークンをテンプレート、共有ログ、サポート投稿に貼り付けないでください。

調べたメタデータ項目をファイル名へ組み合わせる流れの編集図
-K の結果は、その抽出器向けテンプレートで使う項目一覧です。
URLの項目を一覧表示
gallery-dl -K "URL"
ダウンロードせずに抽出を確認
gallery-dl --simulate "URL"
読みやすい名前を作る

gallery-dl のファイル名形式を組み立てる

安定した識別子を軸に、保存後に見つけるため必要な項目だけを加えます。{category}_{id}_{title}.{extension} のような書式は識別しやすく、日付を先頭に置けば時系列で探しやすくなります。利用できる項目は抽出器によって異なるため、-K で一つずつ確認してください。

一度だけ試す場合は --filename が便利です。シミュレーションと少量の実取得で確認できたら、JSON設定の該当抽出器セクションへ移します。設定階層のより深い場所に書かれた値は、一般設定を上書きすることがあります。

区切りは読みやすくし、拡張子は末尾に置きます。タイトルがない投稿にも備え、IDなどの識別項目を残してください。

一時的なファイル名テスト
gallery-dl --filename "{category}_{id}_{title}.{extension}" --simulate "URL"
抽出器ごとの設定例
{
  "extractor": {
    "example": {
      "filename": "{id}_{title}.{extension}"
    }
  }
}
書式の例役立つ場面事前に確認する点
{id}_{extension}タイトルがない、または変わりやすい抽出器が安定したIDを返すか
{date}_{id}_{title}時系列に整理したい日付が一定の形式で得られるか
{author}/{title}作者ごとにフォルダーを分けたい作者値がパスの一部として使えるか
{category}_{id}_{title}.{extension}複数サイトの保存先をまとめるcategory と extension が -K にあるか
コレクションを分ける

ディレクトリーテンプレートで保存先を整理する

extractor.directory は書式文字列のリストを受け取ります。各要素が一つのパス区間になり、base-directory の下に順番に追加されます。長いファイル名へ構造を詰め込まず、サイト、作者、コレクションという階層を明示できます。

フォルダー名に意味がある場合に利用しましょう。作者名やタイトルに区切り文字、予約文字、予想外に長い値が含まれることがあるため、複数のURLで試します。共有先へ移すパスに秘密情報や非公開アカウント名を含めないでください。

サイトと作者で分類
{
  "extractor": {
    "example": {
      "directory": ["{category}", "{author}"],
      "filename": "{id}_{title}.{extension}"
    }
  }
}
メディア別の扱い

条件付きのファイル名形式は少しずつ追加する

設定では条件とファイル名文字列を対応付けられます。条件は記述順に評価され、最初に真になった書式が使われます。空文字列の項目、または抽出器の既定値を代替として用意できます。画像と動画が混在するコレクションなどで役立ちます。

条件分岐は単純な書式より原因を追いにくいため、一つずつ加えます。一致するURLと一致しないURLの両方で試し、代替書式を明確にしてください。-K で見つからない項目を条件式に使わないことも重要です。

動画ファイルを別名にする
{
  "extractor": {
    "example": {
      "filename": {
        "extension == 'mp4'": "{id}_video.{extension}",
        "": "{id}_{title}.{extension}"
      }
    }
  }
}
どの環境でも使える名前に

Windows、Linux、macOSのファイル名制限を確認する

書式が正しくても、OSが許可しないパスになることがあります。タイトルには予約文字や極端に長い文字列が含まれる場合があります。gallery-dl には Windows、Unix、ASCII、独自文字セットなどの制限モードがあります。ジョブを動かす環境に合わせ、実際の結果を確認してください。

複数のOSで同じ設定を使うなら、控えめな区切りと浅いフォルダー階層にします。句読点、タイトル欠落、非ラテン文字、長い値を試します。ファイル名だけでなく、保存先を含めたパス全体の長さを考慮してください。

ファイル名が互換性チェックを通りOSのフォルダーへ整理される編集イラスト
文字、長さ、区切り、最終保存先を合わせて確認します。
テスト項目確認する理由安全な対応
予約文字Windowsで使えない記号がある互換モードを選び、プレビューを確認
長いタイトルパス全体が制限を超える場合があるIDを残し、タイトルを短くする
項目の欠落推測したキーは空になる可能性がある-K と代替書式を使う
非ラテン文字OSやシェルで扱いが異なる場合があるUTF-8を使い対象環境でテスト
結果を確かめる

gallery-dl の命名テンプレートを安全に検証する

対応するURLを一つ選び、-K を実行します。使う項目を控え、短い書式を --simulate で試して出力を確認します。次に少量の範囲を一時フォルダーへ保存し、ファイル名とフォルダー階層の両方を開いて確かめます。

動作したら別のURLでも繰り返し、可能なら記号を含むタイトルやタイトルのない項目を含めます。確認後に恒久設定へ移し、テスト済みコマンドも記録します。

動作が変わったときは --config-status で有効な設定を確認し、--config-ignore --simulate と比較します。正常に動いた設定を保存し、命名ルールを一つずつ変更してください。

設定を無視した比較
gallery-dl --config-ignore --simulate "URL"
有効な設定を確認
gallery-dl --config-status
最初の少量取得
gallery-dl --range "1-3" --filename "{id}_{title}.{extension}" "URL"
問題を切り分ける

空の名前、重複、無効なパスを調べる

汎用名しか付かない場合、項目が存在しない、より具体的な設定に上書きされた、または別の設定ファイルが有効になっている可能性があります。-K と書式を比較し、--config-status と設定を無視したシミュレーションを確認します。

ファイルが飛ばされたり上書きされたりする場合は選択処理を別に確認します。テンプレートは --download-archive の代わりにはならず、ファイルの中身を比較もしません。IDを残し、履歴を変える前にURL、範囲、フィルターを調べてください。

テンプレートの一部が空になる

対象URLで -K を実行し、推測した項目を表示されたキーに置き換えます。テスト中は固定の代替値も残してください。

  • 抽出器を確認
  • 有効設定を確認
  • 一つずつ試す

パスが拒否される

書式を短くし、予約記号を除いて、ジョブを動かす実際の環境で試します。

  • 文字を確認
  • 全体の長さを確認
  • 非ラテン文字もテスト
許可されたURLで再現可能なテストを

テンプレートが行うのはローカル保存の整理です。ログイン、ペイウォール、リクエスト制限、アクセス制御、プラットフォーム規則を回避するものではありません。利用許可のあるURLだけをテストし、認証情報をコマンドやログに含めないでください。

保守しやすいジョブに

繰り返し使える命名手順

テンプレートは短く、抽出器に合わせます。-K で項目を調べ、シミュレーションと境界値テストを行ってから、ジョブを担当する最も具体的な設定階層に保存します。保存先とテスト済みコマンドも記録しておけば、次の変更を推測ではなく比較で確認できます。

よくある質問

gallery-dl ファイル名テンプレートのよくある質問

gallery-dl のファイル名に使える項目をどう調べますか?

gallery-dl -K "URL" を実行します。そのURLの抽出器が提供するファイル名・フォルダー用キーとサンプル値が表示されます。

簡単な gallery-dl のファイル名形式は何ですか?

-K に表示されるなら {id}_{title}.{extension} から始められます。少量のテストが通った後でcategoryや日付を追加してください。

メタデータからフォルダーを作れますか?

はい。extractor.directory は書式文字列のリストを受け取り、各文字列が base-directory の下の一つのフォルダー区間になります。作者名やタイトルもテストしてください。

サイトによって同じテンプレートが動かないのはなぜですか?

置換キーは抽出器によって異なります。URLごとに -K を実行し、サイト固有の設定はその抽出器の階層に置いてください。

Windowsで使えるファイル名にするには?

Windows対応の制限モードと短い書式を使います。予約文字、長いタイトル、項目の欠落、保存先を含むパス全体を実機で確認してください。

ファイル名テンプレートで重複取得を防げますか?

できません。テンプレートは名前だけを制御します。繰り返し実行で取得済み項目を扱うには、--download-archive を利用してください。

公式資料

gallery-dl 公式設定ドキュメントgallery-dl 公式コマンドラインオプションgallery-dl のソースとIssue
次のステップ

関連リソース