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
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.
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.
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.
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é.
gallery-dl -K "URL"gallery-dl --simulate "URL"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.
gallery-dl --filename "{category}_{id}_{title}.{extension}" --simulate "URL"{
"extractor": {
"example": {
"filename": "{id}_{title}.{extension}"
}
}
}| Idée de modèle | Utile quand | À vérifier |
|---|---|---|
| {id}_{extension} | Les titres manquent ou changent | L'extracteur fournit un identifiant stable |
| {date}_{id}_{title} | Vous parcourez les fichiers par date | La date suit un format prévisible |
| {author}/{title} | Chaque créateur doit avoir son dossier | La valeur auteur convient à un chemin |
| {category}_{id}_{title}.{extension} | Plusieurs sites partagent une racine | category et extension figurent dans -K |
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é.
{
"extractor": {
"example": {
"directory": ["{category}", "{author}"],
"filename": "{id}_{title}.{extension}"
}
}
}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.
{
"extractor": {
"example": {
"filename": {
"extension == 'mp4'": "{id}_video.{extension}",
"": "{id}_{title}.{extension}"
}
}
}
}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.
| Cas de test | Pourquoi c'est important | Réponse prudente |
|---|---|---|
| Ponctuation réservée | Windows refuse certains caractères | Choisissez un mode compatible et vérifiez l'aperçu |
| Titre long | Le chemin complet peut dépasser une limite | Gardez l'ID et raccourcissez le titre |
| Champ manquant | Une clé supposée peut rester vide | Consultez -K et prévoyez un repli |
| Texte non latin | Le système de fichiers peut le traiter différemment | Utilisez UTF-8 et testez sur la machine cible |
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.
gallery-dl --config-ignore --simulate "URL"gallery-dl --config-statusgallery-dl --range "1-3" --filename "{id}_{title}.{extension}" "URL"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.
Lancez -K pour cette URL, remplacez les champs supposés et conservez une valeur de repli littérale pendant le test.
Raccourcissez le modèle, retirez les signes réservés et testez sur la machine qui exécutera le travail.
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.
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.
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.
{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.
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.
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.
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.
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.