DOWNLOADS WIEDERFINDEN

gallery-dl Dateinamenvorlagen: Namen, Ordner und Metadaten

gallery-dl Dateinamenvorlagen wandeln Metadaten eines Extractors in nachvollziehbare Dateinamen und Ordnerpfade um. Hier erfahren Sie, wie Sie verfügbare Felder für eine URL ermitteln, ein einfaches Muster aufbauen, ungültige Zeichen behandeln und das Ergebnis vor einem großen Lauf prüfen.

Metadatenbasierte NamenPlanbare OrdnerSicherer Testablauf
Redaktionelle Illustration eines Terminals, das Dateien anhand ihrer Metadaten in Ordner sortiert
Eine Vorlage verbindet Extractor-Felder mit einer wiederholbaren lokalen Ordnerstruktur.
Kurz erklärt: erst prüfen, dann formatieren

Führen Sie gallery-dl -K "URL" aus, um die Ersetzungsschlüssel des verwendeten Extractors zu sehen. Verwenden Sie diese in --filename oder extractor.filename; Ordnersegmente legen Sie mit extractor.directory fest. Prüfen Sie die Ausgabe mit --simulate und einer kleinen URL, bevor Sie die dauerhafte Konfiguration ändern. Ein Schlüssel eines Extractors ist nicht automatisch bei einem anderen verfügbar.

VOM ERGEBNIS AUS PLANEN

Was gallery-dl Dateinamenvorlagen steuern

Eine Dateinamenvorlage ist eine Formatzeichenfolge, die gallery-dl beim Vorbereiten einer Datei auswertet. Sie kann Extractor-Metadaten wie ID, Titel, Datum, Autor, Seitennummer oder Dateiendung mit gut lesbaren Trennzeichen kombinieren. Für Ordner gilt dasselbe Prinzip: Jeder Pfadabschnitt kann einen Metadatenwert enthalten, etwa für Website, Urheber oder Serie.

Die Vorlage ändert die lokale Ablage, nicht die URL oder die Downloadentscheidung des Extractors. Beginnen Sie mit einem kurzen, eindeutigen und lesbaren Muster, das auf allen Rechnern funktioniert, auf denen der Job läuft.

ECHTE FELDER ERMITTELN

Mit -K verfügbare Ersetzungsschlüssel anzeigen

Die offizielle Konfigurationsdokumentation empfiehlt -K oder --list-keywords für eine konkrete URL. Die Ausgabe enthält Schlüssel für Ordner und Dateinamen sowie Beispielwerte. Sie legt fest, welche Felder für eine verlässliche Vorlage geeignet sind. Verlassen Sie sich auf die Ausgabe des verwendeten Extractors statt auf geratene Variablen, Beispiele für eine andere Website oder veraltete Anleitungen.

Wählen Sie eine öffentliche URL, auf die Sie zugreifen dürfen, und halten Sie die erste Prüfung klein. Erfordert die Website eine Anmeldung, lösen Sie das getrennt über den normalen Anmeldeweg und lokale Browser-Cookies. Kopieren Sie niemals Cookies oder private Token in eine Vorlage, einen Fehlerbericht oder ein geteiltes Protokoll.

Redaktionelles Diagramm, das geprüfte Metadatenfelder zu einem Dateinamen zusammenführt
Die -K-Ausgabe zeigt, welche Felder für eine Vorlage dieses Extractors verfügbar sind.
Felder einer URL auflisten
gallery-dl -K "URL"
Extraktion ohne Download simulieren
gallery-dl --simulate "URL"
EINEN LESBAREN NAMEN BAUEN

Ein gallery-dl Dateinamensformat erstellen

Beginnen Sie mit einer stabilen Kennung und ergänzen Sie nur Felder, die Sie später zum Auffinden nutzen. Ein Muster wie {category}_{id}_{title}.{extension} ist leicht zu erkennen; ein Datum am Anfang erleichtert die chronologische Sortierung. Welche Felder verfügbar sind, hängt vom Extractor ab. Prüfen Sie jedes davon mit -K.

Für einen einmaligen Test eignet sich --filename. Nachdem Simulation und ein kleiner echter Lauf funktioniert haben, können Sie das Muster in den passenden Extractor-Abschnitt der JSON-Konfiguration übernehmen. Ein spezifischerer Eintrag kann einen allgemeinen Wert überschreiben.

Verwenden Sie klare Trennzeichen und setzen Sie die Endung ans Ende. Eine Kennung hilft auch dann, wenn ein Beitrag keinen Titel besitzt.

Einmaliger Namenstest
gallery-dl --filename "{category}_{id}_{title}.{extension}" --simulate "URL"
Extractor-spezifische Konfiguration
{
  "extractor": {
    "example": {
      "filename": "{id}_{title}.{extension}"
    }
  }
}
MusterideeHilfreich, wennVorher prüfen
{id}_{extension}Titel fehlen oder ändern sichDer Extractor eine stabile ID liefert
{date}_{id}_{title}Sie zeitlich sortieren möchtenDas Datum ein verlässliches Format hat
{author}/{title}Jeder Urheber einen eigenen Ordner erhalten sollDer Autorenwert als Pfadsegment geeignet ist
{category}_{id}_{title}.{extension}Mehrere Websites denselben Basisordner nutzencategory und extension in -K erscheinen
SAMMLUNGEN TRENNEN

Mit Verzeichnisvorlagen vorhersehbare Ordner anlegen

Die Option extractor.directory nimmt eine Liste von Formatzeichenfolgen an. Jeder Eintrag wird zu einem Pfadsegment, das unter dem Basisverzeichnis angelegt wird. So lässt sich eine Struktur nach Website, Urheber und Sammlung ausdrücklich festlegen, statt alles in einen langen Dateinamen zu packen.

Nutzen Sie Verzeichnisvorlagen, wenn die Ordnerstruktur Ihrem Ablauf hilft. Testen Sie Autor- und Titelwerte auf Schrägstriche, reservierte Zeichen und unerwartete Länge. Pfade, die weitergegeben werden, dürfen keine Geheimnisse oder privaten Kontonamen enthalten.

Nach Website und Autor sortieren
{
  "extractor": {
    "example": {
      "directory": ["{category}", "{author}"],
      "filename": "{id}_{title}.{extension}"
    }
  }
}
MEDIENTYPEN UNTERSCHEIDEN

Bedingte Dateinamensformate vorsichtig ergänzen

In der Konfiguration können Bedingungen verschiedenen Dateinamenszeichenfolgen zugeordnet werden. Sie werden in der angegebenen Reihenfolge geprüft; die erste zutreffende Bedingung gewinnt. Ein leerer Schlüssel oder der Standard des Extractors kann als Ersatz dienen. Das hilft etwa bei Sammlungen mit Videos und Bildern.

Bedingungen sind schwieriger zu untersuchen als eine einzelne Zeichenfolge. Ergänzen Sie sie einzeln und testen Sie sowohl passende als auch unpassende URLs. Halten Sie den Ersatz eindeutig und nutzen Sie nur Felder, die -K anzeigt.

Videodateien anders benennen
{
  "extractor": {
    "example": {
      "filename": {
        "extension == 'mp4'": "{id}_video.{extension}",
        "": "{id}_{title}.{extension}"
      }
    }
  }
}
PLATTFORMÜBERGREIFEND PLANEN

Dateinamenlimits von Windows, Linux und macOS beachten

Ein syntaktisch gültiges Muster kann trotzdem einen vom Betriebssystem abgelehnten Pfad erzeugen. Titel können reservierte Zeichen oder sehr lange Texte enthalten. gallery-dl bietet Einschränkungen für Windows, Unix, ASCII und benutzerdefinierte Zeichensätze. Wählen Sie den Modus passend zu den ausführenden Rechnern und prüfen Sie das Ergebnis.

Bei gemeinsam genutzten Konfigurationen sind einfache Trennzeichen und wenige Ordnerebenen sinnvoll. Testen Sie Satzzeichen, fehlende Titel, nichtlateinische Namen und lange Werte. Entscheidend ist der vollständige Pfad einschließlich Zielverzeichnis, nicht nur der Dateiname.

Redaktionelle Illustration einer Dateinamensprüfung vor der Ablage in Ordnern verschiedener Betriebssysteme
Die plattformübergreifende Prüfung umfasst Zeichen, Länge und Zielpfad.
TestfallWarum wichtigVorsichtige Lösung
Reservierte SatzzeichenWindows weist manche Zeichen zurückKompatiblen Modus wählen und Vorschau prüfen
Langer TitelDer Gesamtpfad kann zu lang werdenID behalten und Titel verkürzen
Fehlendes FeldEin geratener Schlüssel kann leer bleiben-K nutzen und Ersatz vorsehen
Nichtlateinischer TextDateisysteme können ihn unterschiedlich behandelnUTF-8 nutzen und auf dem Zielgerät testen
ERGEBNIS NACHWEISEN

Ein sicherer Ablauf zum Prüfen von gallery-dl Vorlagen

Wählen Sie eine unterstützte URL und führen Sie -K aus. Notieren Sie die benötigten Felder, testen Sie das kürzeste sinnvolle Muster mit --simulate und lesen Sie die Ausgabe. Laden Sie danach einen kleinen Bereich in ein temporäres Ziel und prüfen Sie Namen und Ordnerstruktur, indem Sie die Dateien öffnen.

Wiederholen Sie den Test mit einer zweiten repräsentativen URL. Falls möglich, sollte ein Titel mit Satzzeichen oder ohne Titel dabei sein. Erst wenn das klappt, gehört die Einstellung in eine dauerhafte Konfiguration; dokumentieren Sie auch den getesteten Befehl.

Wenn sich das Verhalten ändert, zeigt --config-status aktive Dateien. Vergleichen Sie anschließend mit --config-ignore --simulate, sichern Sie eine funktionierende Konfiguration und ändern Sie nur eine Regel auf einmal.

Vergleich ohne Konfiguration
gallery-dl --config-ignore --simulate "URL"
Aktive Konfiguration anzeigen
gallery-dl --config-status
Kleiner erster Lauf
gallery-dl --range "1-3" --filename "{id}_{title}.{extension}" "URL"
FEHLER EINGRENZEN

Leere Namen, Überschreibungen oder ungültige Pfade beheben

Generische Namen können auf ein fehlendes Feld, eine spezifischere Überschreibung oder eine andere aktive Konfigurationsdatei hinweisen. Vergleichen Sie -K mit dem Muster, prüfen Sie --config-status und führen Sie eine Simulation ohne Konfiguration aus.

Übersprungene oder überschriebene Dateien sind zunächst ein Auswahlproblem. Eine Vorlage ersetzt weder --download-archive noch einen Inhaltsvergleich. Behalten Sie eine ID im Namen und prüfen Sie URL, Bereich und Filter, bevor Sie den Verlauf ändern.

Die Vorlage erzeugt leere Stellen

Führen Sie -K für genau diese URL aus, ersetzen Sie geratene Felder und nutzen Sie beim Test einen festen Ersatzwert.

  • Extractor bestätigen
  • Aktive Konfiguration prüfen
  • Ein Feld nach dem anderen testen

Der Pfad wird abgelehnt

Kürzen Sie das Muster, entfernen Sie reservierte Zeichen und testen Sie auf dem Rechner, auf dem der Job läuft.

  • Zeichen prüfen
  • Gesamtlänge prüfen
  • Nichtlateinische Werte testen
Nur erlaubte und reproduzierbare Tests nutzen

Dateinamenvorlagen organisieren lokale Downloads. Sie umgehen keine Anmeldung, Bezahlschranke, Ratenbegrenzung, Zugriffskontrolle oder Plattformregel. Testen Sie nur URLs und Medien, auf die Sie zugreifen dürfen, und halten Sie Zugangsdaten aus Befehlen und Protokollen heraus.

DEN JOB WARTBAR HALTEN

Eine wiederholbare Benennungsroutine

Halten Sie die Vorlage kurz und auf den Extractor abgestimmt. Ermitteln Sie Felder mit -K, simulieren Sie, prüfen Sie einige Grenzfälle und speichern Sie das Muster auf der passendsten Konfigurationsebene. Dokumentieren Sie Zielordner und getesteten Befehl, damit spätere Änderungen nachvollziehbar bleiben.

Häufige Fragen

Häufige Fragen zu gallery-dl Dateinamenvorlagen

Wie finde ich die Felder für gallery-dl Dateinamen?

Führen Sie gallery-dl -K "URL" aus. Die Ausgabe listet Datei- und Ordnerschlüssel mit Beispielwerten für den Extractor dieser URL.

Welches einfache Dateinamensformat eignet sich für gallery-dl?

Wenn -K die Felder anzeigt, ist {id}_{title}.{extension} ein guter Start. Kategorie oder Datum ergänzen Sie nach einem erfolgreichen kleinen Test.

Kann gallery-dl Ordner anhand von Metadaten anlegen?

Ja. extractor.directory nimmt eine Liste von Formatzeichenfolgen an, deren Einträge jeweils ein Segment unterhalb des Basisordners bilden. Testen Sie Autor- und Titelwerte.

Warum funktioniert eine Vorlage bei einer Website, aber nicht bei einer anderen?

Ersetzungsschlüssel hängen vom Extractor ab. Führen Sie -K für jede URL aus und legen Sie Website-spezifische Werte auf der passenden Extractor-Ebene ab.

Wie mache ich gallery-dl Dateinamen Windows-kompatibel?

Nutzen Sie einen Windows-kompatiblen Einschränkungsmodus, einfache Trennzeichen und ein kurzes Muster. Prüfen Sie reservierte Zeichen, lange oder fehlende Titel und den vollständigen Zielpfad.

Verhindert eine Dateinamenvorlage doppelte Downloads?

Nein. Sie bestimmt nur lokale Namen. Für den Verlauf über wiederholte Läufe verwenden Sie eine stabile --download-archive-Datei und behalten eine ID im Namen.

Offizielle Quellen

Offizielle gallery-dl KonfigurationsdokumentationOffizielle gallery-dl Befehlszeilenoptionengallery-dl Quellcode und Issues
NÄCHSTER SCHRITT

Verwandte Ressourcen