Windows 11/10  ·  Configuración JSON  ·  Ejemplos para copiar

Archivo de Configuración gallery-dl en Windows — Guía de Configuración

El archivo de configuración de gallery-dl permite definir ajustes permanentes — carpeta de salida, plantillas de nombre de archivo, rate limiting, cookies y opciones por sitio. Sin necesidad de repetir flags en cada comando.

Ubicación del archivo de configuración

¿Dónde busca gallery-dl el archivo de configuración en Windows?

gallery-dl comprueba estas ubicaciones en orden — se usa la primera que encuentre.

Prioridad 1
%APPDATA%\gallery-dl\config.json

ej: C:\Users\TuNombre\AppData\Roaming\gallery-dl\config.json — recomendado para configuración permanente

Prioridad 2
gallery-dl.conf (misma carpeta que gallery-dl.exe)

Configuración portable — viaja con el ejecutable

Flag CLI
gallery-dl --config "C:\ruta\a\miconfig.json" "URL"

Sobreescribir la ruta de configuración por comando

Consejo: Crea la carpeta %APPDATA%\gallery-dl\ si no existe. Pulsa Win+R, escribe %APPDATA%, pulsa Intro, luego crea una nueva carpeta llamada gallery-dl.

Configuración inicial

Configuración gallery-dl recomendada para Windows — copia & pega

Guarda como config.json en %APPDATA%\gallery-dl\. Edita las rutas y opciones según tus necesidades.

gallery-dl.conf — configuración inicial recomendada para Windows
{ "extractor": { "base-directory": "C:/Imagenes/", "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 } }
Nota: JSON requiere comillas dobles y sin comas al final. Usa barras normales / en las rutas — funcionan bien en Windows y evitan problemas de escape JSON con barras inversas.

Opciones principales explicadas

Opciones de configuración gallery-dl más útiles para Windows

Definir carpeta de descarga — se aplica a todos los sitios
"base-directory": "C:/Imagenes/"
Plantilla de nombre de archivo personalizada — categoría + autor + número + nombre original
"filename": "{category}_{author}_{num:>04}_{filename}.{extension}"
Carpeta de salida por sitio — Instagram en su propia subcarpeta
"directory": ["{category}", "{uploader}"]
Ralentizar peticiones para evitar rate limiting (segundos entre peticiones)
"sleep-request": 2.0
Limitar velocidad de descarga (útil en conexiones compartidas)
"rate": "2M"
Definir archivo de cookies para un sitio específico (ejemplo Instagram)
"instagram": { "cookies": "C:/Tools/gallery-dl/instagram-cookies.txt" }

Plantillas de nombre de archivo

Variables de plantilla de nombre de archivo gallery-dl — Windows

Usa estas variables en los ajustes "filename" y "directory".

{filename}
Nombre de archivo original
{extension}
Extensión de archivo (jpg, png…)
{category}
Nombre del sitio (instagram, twitter…)
{author}
Nombre del autor/uploader
{uploader}
Nombre de usuario/handle
{num}
Número secuencial
{date}
Fecha de publicación
{title}
Título de la publicación (si disponible)
{id}
ID de la publicación/imagen

Números con ceros: {num:>04} → 0001, 0042. Formato de fecha: {date:%Y-%m-%d} → 2026-06-09.

Preguntas frecuentes

Configuración gallery-dl — preguntas frecuentes

¿Dónde está el archivo de configuración de gallery-dl en Windows?
La ubicación por defecto es %APPDATA%\gallery-dl\config.json. Abre Ejecutar (Win+R), escribe %APPDATA%\gallery-dl y pulsa Intro para navegar directamente. También puedes colocar gallery-dl.conf en la misma carpeta que gallery-dl.exe para configuración portable.
gallery-dl dice «archivo de configuración no encontrado» — ¿cómo resolverlo?
gallery-dl no requiere un archivo de configuración — funciona sin uno. Si quieres crear uno: crea la carpeta %APPDATA%\gallery-dl\ y guarda tu archivo JSON allí como config.json. Verifica que es JSON válido — cualquier coma o comilla faltante lo romperá.
¿Cómo valido mi configuración JSON de gallery-dl?
Pega tu configuración en jsonlint.com para comprobar errores de sintaxis. Errores comunes: comas al final del último elemento, comillas simples en lugar de dobles, barras inversas de Windows en las rutas (usa barras normales o escápelas con \\).
¿Puedo tener ajustes diferentes para diferentes sitios?
Sí. Coloca ajustes específicos del sitio bajo la clave del nombre del sitio. Ejemplo: "instagram": {"sleep-request": 3} dentro del objeto "extractor". Las claves de sitio corresponden a la variable {category} — instagram, twitter, pixiv, deviantart, reddit, etc.