Windows 11/10  ·  Configuration JSON  ·  Exemples à copier

Fichier de Configuration gallery-dl sur Windows — Guide de Configuration

Le fichier de configuration de gallery-dl permet de définir des paramètres permanents — dossier de sortie, modèles de noms de fichiers, rate limiting, cookies et options par site. Inutile de répéter les flags à chaque commande.

Emplacement du fichier de configuration

Où gallery-dl cherche-t-il le fichier de configuration sur Windows ?

gallery-dl vérifie ces emplacements dans l'ordre — le premier trouvé est utilisé.

Priorité 1
%APPDATA%\gallery-dl\config.json

ex : C:\Users\VotreNom\AppData\Roaming\gallery-dl\config.json — recommandé pour une configuration permanente

Priorité 2
gallery-dl.conf (même dossier que gallery-dl.exe)

Configuration portable — voyage avec l'exécutable

Flag CLI
gallery-dl --config "C:\chemin\vers\maconfig.json" "URL"

Remplacer le chemin de configuration par commande

Astuce : Créez le dossier %APPDATA%\gallery-dl\ s'il n'existe pas. Appuyez sur Win+R, tapez %APPDATA%, appuyez sur Entrée, puis créez un nouveau dossier nommé gallery-dl.

Configuration de départ

Configuration gallery-dl recommandée pour Windows — copiez & collez

Sauvegardez comme config.json dans %APPDATA%\gallery-dl\. Modifiez les chemins et options selon vos besoins.

gallery-dl.conf — configuration de départ recommandée pour Windows
{ "extractor": { "base-directory": "C:/Images/", "filename": "{category}_{author}_{num:>04}_{filename}.{extension}", "sleep-request": 1.5, "retries": 5, "timeout": 30, "verify": true }, "downloader": { "part": true, "rate": "2M" }, "output": { "mode": "terminal", "progress": true, "shorten": true } }
Note : JSON nécessite des guillemets doubles et pas de virgules finales. Utilisez des barres obliques / dans les chemins — elles fonctionnent parfaitement sur Windows et évitent les problèmes d'échappement JSON avec les barres obliques inverses.

Options principales expliquées

Options de configuration gallery-dl les plus utiles pour Windows

Définir le dossier de téléchargement — s'applique à tous les sites
"base-directory": "C:/Images/"
Modèle de nom de fichier personnalisé — catégorie + auteur + numéro + nom original
"filename": "{category}_{author}_{num:>04}_{filename}.{extension}"
Dossier de sortie par site — Instagram dans son propre sous-dossier
"directory": ["{category}", "{uploader}"]
Ralentir les requêtes pour éviter le rate limiting (secondes entre les requêtes)
"sleep-request": 2.0
Limiter la vitesse de téléchargement (utile sur les connexions partagées)
"rate": "2M"
Définir le fichier de cookies pour un site spécifique (exemple Instagram)
"instagram": { "cookies": "C:/Tools/gallery-dl/instagram-cookies.txt" }

Modèles de noms de fichiers

Variables de modèle de nom de fichier gallery-dl — Windows

Utilisez ces variables dans les paramètres "filename" et "directory".

{filename}
Nom de fichier original
{extension}
Extension de fichier (jpg, png…)
{category}
Nom du site (instagram, twitter…)
{author}
Nom de l'auteur/uploader
{uploader}
Nom d'utilisateur/pseudo
{num}
Numéro séquentiel
{date}
Date de publication
{title}
Titre de la publication (si disponible)
{id}
ID de la publication/image

Numéros avec zéros : {num:>04} → 0001, 0042. Format de date : {date:%Y-%m-%d} → 2026-06-09.

FAQ

Configuration gallery-dl — questions fréquentes

Où se trouve le fichier de configuration de gallery-dl sur Windows ?
L'emplacement par défaut est %APPDATA%\gallery-dl\config.json. Ouvrez Exécuter (Win+R), tapez %APPDATA%\gallery-dl et appuyez sur Entrée pour y naviguer directement. Vous pouvez aussi placer gallery-dl.conf dans le même dossier que gallery-dl.exe pour une configuration portable.
gallery-dl dit « fichier de configuration introuvable » — comment résoudre ?
gallery-dl ne nécessite pas de fichier de configuration — il fonctionne sans. Si vous voulez en créer un : créez le dossier %APPDATA%\gallery-dl\ et sauvegardez votre fichier JSON là en tant que config.json. Vérifiez que c'est du JSON valide — une virgule ou guillemet manquant cassera tout.
Comment valider ma configuration JSON gallery-dl ?
Collez votre configuration sur jsonlint.com pour vérifier les erreurs de syntaxe. Erreurs courantes : virgules finales après le dernier élément, guillemets simples au lieu de doubles, barres obliques inverses Windows dans les chemins (utilisez des barres obliques ou échappez-les avec \\).
Puis-je avoir des paramètres différents pour différents sites ?
Oui. Placez les paramètres spécifiques au site sous la clé du nom du site. Exemple : "instagram": {"sleep-request": 3} dans l'objet "extractor". Les clés de site correspondent à la variable {category} — instagram, twitter, pixiv, deviantart, reddit, etc.
Comment définir un dossier de téléchargement différent par site ?
Utilisez l'option "directory" par extracteur de site. Exemple : "instagram": {"directory": ["C:/Insta/", "{uploader}"]}. Cela crée automatiquement un sous-dossier par nom d'utilisateur.