RETROUVEZ VOS TÉLÉCHARGEMENTS

Modèles de noms de fichiers gallery-dl : noms, dossiers et métadonnées

Les modèles de noms de fichiers gallery-dl transforment les métadonnées d'un extracteur en noms de fichiers et chemins prévisibles. Apprenez à repérer les champs disponibles pour une URL, à composer un format simple, à gérer les caractères incompatibles et à vérifier le résultat avant de traiter une grande collection.

Noms fondés sur les métadonnéesDossiers prévisiblesTests prudents
Illustration éditoriale d'un terminal qui envoie des fichiers associés à leurs métadonnées dans des dossiers organisés
Un modèle relie les champs de l'extracteur à une structure locale que vous pouvez réutiliser.
Réponse courte : inspectez, puis formatez

Lancez gallery-dl -K "URL" pour afficher les clés de remplacement proposées par l'extracteur concerné. Utilisez-les dans --filename ou extractor.filename, puis définissez les segments de dossier avec extractor.directory. Vérifiez le résultat avec --simulate et une URL limitée avant d'enregistrer une configuration permanente. Une clé disponible sur un extracteur ne l'est pas forcément sur un autre.

PARTIR DU RÉSULTAT

Ce que contrôlent les modèles de noms gallery-dl

Les modèles de noms de fichiers gallery-dl sont des chaînes évaluées au moment de préparer un fichier. Ils réunissent des métadonnées de l'extracteur, comme un identifiant, un titre, une date, un auteur, un numéro de page ou une extension, avec des séparateurs lisibles. Les dossiers suivent le même principe : chaque segment peut classer une collection par site, créateur ou série.

Le modèle organise les fichiers localement ; il ne modifie ni l'URL ni la décision de téléchargement de l'extracteur. Commencez avec un motif court, unique, lisible et accepté par les machines qui exécutent la tâche.

DÉCOUVRIR LES CHAMPS RÉELS

Afficher les clés disponibles avec -K

La documentation officielle recommande -K ou --list-keywords avec une URL précise. La commande affiche les clés pour les dossiers et les fichiers, avec des valeurs d'exemple. Cette sortie fixe les limites d'un modèle fiable : elle décrit les données fournies par cet extracteur au lieu de reprendre une variable supposée, une autre plateforme ou un ancien tutoriel.

Choisissez une URL publique à laquelle vous êtes autorisé à accéder et limitez le premier contrôle. Si une connexion est requise, gérez-la séparément avec la procédure normale du site et les cookies locaux du navigateur. Ne copiez jamais de cookies ou de jetons privés dans un modèle ou un journal partagé.

Schéma éditorial montrant des champs de métadonnées inspectés puis combinés dans un nom de fichier
La sortie de -K indique les champs à employer pour l'extracteur concerné.
Lister les champs d'une URL
gallery-dl -K "URL"
Simuler l'extraction sans télécharger
gallery-dl --simulate "URL"
CRÉER UN NOM LISIBLE

Composer un format de nom de fichier gallery-dl

Commencez par un identifiant stable et n'ajoutez que les champs utiles pour parcourir le dossier. Un motif comme {category}_{id}_{title}.{extension} est facile à reconnaître ; une date en premier facilite un classement chronologique. Les champs disponibles varient selon l'extracteur : confirmez chacun avec -K.

Utilisez --filename pour un essai ponctuel. Après une simulation et un petit téléchargement réussis, placez le modèle dans la section JSON de l'extracteur correspondant. Un réglage situé à un niveau plus précis peut remplacer un réglage général.

Choisissez des séparateurs lisibles et gardez l'extension à la fin. Conservez un identifiant de secours lorsque le titre manque.

Essai ponctuel du nom
gallery-dl --filename "{category}_{id}_{title}.{extension}" --simulate "URL"
Configuration propre à l'extracteur
{
  "extractor": {
    "example": {
      "filename": "{id}_{title}.{extension}"
    }
  }
}
Idée de modèleUtile quandÀ vérifier
{id}_{extension}Les titres manquent ou changentL'extracteur fournit un identifiant stable
{date}_{id}_{title}Vous parcourez les fichiers par dateLa date suit un format prévisible
{author}/{title}Chaque créateur doit avoir son dossierLa valeur auteur convient à un chemin
{category}_{id}_{title}.{extension}Plusieurs sites partagent une racinecategory et extension figurent dans -K
SÉPARER LES COLLECTIONS

Organiser les dossiers avec directory

L'option extractor.directory accepte une liste de chaînes de format. Chaque élément devient un segment de chemin, ajouté sous le répertoire de base. Vous pouvez ainsi définir clairement une organisation par site, auteur et collection au lieu de tout intégrer dans un nom de fichier long.

Utilisez ces dossiers lorsqu'ils apportent une vraie structure au travail. Testez les valeurs d'auteur et de titre pour repérer les séparateurs, caractères réservés ou textes trop longs. N'inscrivez ni secret ni nom de compte privé dans un chemin destiné à être partagé.

Classer par site et par auteur
{
  "extractor": {
    "example": {
      "directory": ["{category}", "{author}"],
      "filename": "{id}_{title}.{extension}"
    }
  }
}
GÉRER LES MÉDIAS DIFFÉRENTS

Ajouter prudemment des formats conditionnels

La configuration peut associer des conditions à plusieurs chaînes de nom. Elles sont évaluées dans l'ordre ; le premier résultat vrai est utilisé. Une entrée vide ou le nom par défaut de l'extracteur peut servir de solution de repli. C'est utile lorsque la même collection contient des images et des vidéos.

Les conditions sont plus difficiles à diagnostiquer qu'une chaîne simple. Ajoutez-en une à la fois et testez une URL correspondante ainsi qu'une autre qui ne l'est pas. Gardez un repli clair et utilisez uniquement des champs affichés par -K.

Séparer les noms des vidéos
{
  "extractor": {
    "example": {
      "filename": {
        "extension == 'mp4'": "{id}_video.{extension}",
        "": "{id}_{title}.{extension}"
      }
    }
  }
}
GARDER LES NOMS PORTABLES

Vérifier les limites de Windows, Linux et macOS

Un modèle valide peut produire un chemin refusé par le système. Les titres peuvent contenir des caractères réservés ou être très longs. gallery-dl propose des modes de restriction Windows, Unix, ASCII et personnalisés ; choisissez celui qui correspond aux machines utilisées et inspectez le résultat.

Si une même configuration sert sur plusieurs systèmes, adoptez des séparateurs prudents et limitez la profondeur des dossiers. Testez la ponctuation, les titres manquants, les noms non latins et les longues valeurs. La longueur du chemin complet compte autant que celle du fichier.

Illustration d'un nom de fichier vérifié avant d'être envoyé vers des dossiers de plusieurs systèmes
La validation porte sur les caractères, la longueur et le chemin de destination.
Cas de testPourquoi c'est importantRéponse prudente
Ponctuation réservéeWindows refuse certains caractèresChoisissez un mode compatible et vérifiez l'aperçu
Titre longLe chemin complet peut dépasser une limiteGardez l'ID et raccourcissez le titre
Champ manquantUne clé supposée peut rester videConsultez -K et prévoyez un repli
Texte non latinLe système de fichiers peut le traiter différemmentUtilisez UTF-8 et testez sur la machine cible
PROUVER LE RÉSULTAT

Une procédure sûre pour valider un modèle gallery-dl

Choisissez une URL prise en charge et lancez -K. Notez les champs utiles, essayez le motif le plus court avec --simulate et examinez la sortie. Téléchargez ensuite une petite plage vers un dossier temporaire, puis vérifiez les noms et l'arborescence en ouvrant les fichiers.

Répétez le test avec une autre URL représentative. Si le site le permet, incluez un titre avec ponctuation ou sans titre. Une fois le résultat validé, ajoutez le réglage à la configuration permanente et conservez la commande testée dans la documentation de la tâche.

Si le comportement change, utilisez --config-status puis comparez avec --config-ignore --simulate. Gardez une copie de la configuration fonctionnelle et ne modifiez qu'une règle de nom à la fois.

Comparer sans configuration
gallery-dl --config-ignore --simulate "URL"
Voir la configuration active
gallery-dl --config-status
Premier petit téléchargement
gallery-dl --range "1-3" --filename "{id}_{title}.{extension}" "URL"
ISOLER LE PROBLÈME

Corriger les noms vides, répétés ou les chemins refusés

Des noms génériques peuvent signaler un champ absent, un réglage plus spécifique qui remplace le vôtre ou une autre configuration active. Comparez -K au modèle, vérifiez --config-status et lancez une simulation sans configuration.

Les fichiers ignorés ou écrasés relèvent d'un autre problème de sélection. Un modèle ne remplace pas --download-archive et ne compare pas les octets des fichiers. Gardez un identifiant et examinez l'URL, la plage et les filtres avant de modifier l'historique.

Le modèle produit des blancs

Lancez -K pour cette URL, remplacez les champs supposés et conservez une valeur de repli littérale pendant le test.

  • Confirmez l'extracteur
  • Vérifiez la configuration active
  • Testez un champ à la fois

Le chemin est refusé

Raccourcissez le modèle, retirez les signes réservés et testez sur la machine qui exécutera le travail.

  • Vérifiez les caractères
  • Vérifiez la longueur totale
  • Testez des valeurs non latines
Effectuer des tests autorisés et reproductibles

Les modèles organisent les téléchargements locaux. Ils ne contournent ni connexion, ni paywall, ni limitation de requêtes, ni contrôle d'accès, ni règle de plateforme. Testez uniquement des URL et des médias auxquels vous êtes autorisé à accéder et gardez les identifiants hors des commandes et journaux.

GARDER UNE TÂCHE MAINTENABLE

Une routine de nommage facile à maintenir

Gardez un modèle court et propre à l'extracteur. Découvrez les clés avec -K, simulez, testez quelques cas limites puis enregistrez le réglage au niveau le plus précis. Documentez également la destination et la commande testée afin de pouvoir comparer les changements futurs.

Questions fréquentes

Questions fréquentes sur les modèles de noms gallery-dl

Comment voir les champs disponibles pour un nom gallery-dl ?

Lancez gallery-dl -K "URL". La commande affiche les clés pour les noms et les dossiers, avec des exemples propres à l'extracteur de cette URL.

Quel est un format de nom gallery-dl simple ?

{id}_{title}.{extension} est un bon point de départ si -K affiche ces champs. Ajoutez une catégorie ou une date après avoir validé un petit test.

Peut-on créer des dossiers avec les métadonnées gallery-dl ?

Oui. extractor.directory accepte une liste de chaînes de format ; chacune devient un segment sous le répertoire de base. Testez les valeurs d'auteur et de titre.

Pourquoi le modèle fonctionne-t-il sur un site mais pas sur un autre ?

Les clés dépendent de l'extracteur. Lancez -K pour chaque URL et gardez les réglages propres au site dans le niveau de configuration correspondant.

Comment rendre les noms compatibles avec Windows ?

Choisissez un mode de restriction Windows, utilisez des séparateurs simples et un motif court. Testez la ponctuation réservée, les titres longs ou manquants et le chemin complet.

Un modèle de nom évite-t-il les téléchargements en double ?

Non. Il contrôle seulement le nom local. Pour l'historique entre plusieurs exécutions, utilisez un fichier --download-archive stable et gardez un identifiant dans le nom.

Références officielles

Documentation officielle de configuration gallery-dlOptions officielles de ligne de commande gallery-dlCode source et problèmes gallery-dl
ÉTAPE SUIVANTE

Ressources associées