La plantilla produce espacios vacíos
Ejecuta -K con esa URL, sustituye los campos supuestos y conserva una alternativa literal durante la prueba.
- Confirma el extractor
- Revisa la configuración activa
- Prueba un campo cada vez
Las plantillas de nombres de archivo de gallery-dl convierten los metadatos del extractor en nombres y rutas previsibles. Aprende a descubrir los campos disponibles para una URL, crear un formato sencillo, limitar caracteres incompatibles y comprobar el resultado antes de procesar una colección completa.
Ejecuta gallery-dl -K "URL" para consultar las claves disponibles en ese extractor. Úsalas en una cadena --filename o extractor.filename y crea carpetas con extractor.directory. Comprueba el resultado con --simulate y una URL pequeña antes de guardar una configuración permanente. Una clave válida en un extractor no tiene por qué existir en otro.
Una plantilla de nombre es una cadena de formato que gallery-dl evalúa al preparar cada archivo. Puede combinar metadatos del extractor, como un identificador, título, fecha, autor, número de página o extensión, con separadores que facilitan la lectura. Las carpetas funcionan de forma similar: cada segmento puede usar un valor de metadatos para ordenar una colección por sitio, creador o serie.
La plantilla cambia la organización local, no la URL ni la decisión del extractor. Empieza con un patrón corto, único, legible y compatible con los equipos que ejecutarán el trabajo.
La documentación oficial recomienda -K o --list-keywords con una URL concreta. El comando muestra las claves para carpetas y nombres junto con valores de ejemplo. Esa salida marca los límites de una plantilla fiable: indica qué ofrece ese extractor en vez de depender de variables supuestas, de otro sitio o de una guía antigua.
Elige una URL pública a la que tengas permiso de acceso y limita la primera inspección. Si hace falta iniciar sesión, resuélvelo por separado mediante el flujo normal del sitio y las cookies locales del navegador. No pegues cookies ni tokens privados en plantillas, incidencias o registros compartidos.
gallery-dl -K "URL"gallery-dl --simulate "URL"Empieza con un identificador estable y añade solo los campos que usarás al explorar la carpeta. Un patrón como {category}_{id}_{title}.{extension} es fácil de reconocer; una fecha al principio ayuda a ordenar cronológicamente. Los campos exactos dependen del extractor, así que confirma cada uno con -K.
Usa --filename para una prueba puntual. Cuando la simulación y una descarga pequeña funcionen, mueve el patrón a la sección del extractor correspondiente en la configuración JSON. Los valores de una sección más específica pueden sustituir los generales.
Elige separadores claros y deja la extensión al final. Conserva un identificador de reserva si alguna publicación no tiene título.
gallery-dl --filename "{category}_{id}_{title}.{extension}" --simulate "URL"{
"extractor": {
"example": {
"filename": "{id}_{title}.{extension}"
}
}
}| Idea de patrón | Cuándo resulta útil | Qué comprobar |
|---|---|---|
| {id}_{extension} | Los títulos faltan o cambian | Que el extractor muestre un ID estable |
| {date}_{id}_{title} | Exploras por fecha | Que la fecha tenga un formato previsible |
| {author}/{title} | Cada creador tiene su carpeta | Que el autor sea válido como ruta |
| {category}_{id}_{title}.{extension} | Compartes una carpeta raíz entre sitios | Que categoría y extensión aparezcan en -K |
La opción extractor.directory acepta una lista de cadenas de formato. Cada elemento se convierte en un segmento de la ruta y todos se colocan bajo el directorio base. Así puedes expresar con claridad una estructura por sitio, autor y colección, en vez de ocultarla en un nombre largo.
Usa estas carpetas si aportan significado al flujo de trabajo. Comprueba valores de autor y título que puedan contener separadores, caracteres reservados o texto muy largo. Nunca incluyas secretos o nombres privados de cuentas en rutas compartidas.
{
"extractor": {
"example": {
"directory": ["{category}", "{author}"],
"filename": "{id}_{title}.{extension}"
}
}
}La configuración puede asociar condiciones con distintas cadenas de nombre. Se evalúan en orden y se usa la primera condición verdadera; una entrada vacía o el formato predeterminado del extractor puede servir de alternativa. Esto ayuda cuando una colección combina vídeo e imágenes.
Las condiciones son más difíciles de depurar que una cadena sencilla. Añade una cada vez y prueba una URL que coincida y otra que no. Mantén clara la alternativa y utiliza solo campos que aparezcan en -K.
{
"extractor": {
"example": {
"filename": {
"extension == 'mp4'": "{id}_video.{extension}",
"": "{id}_{title}.{extension}"
}
}
}
}Una plantilla válida puede producir una ruta que el sistema rechace. Los títulos pueden contener caracteres reservados o ser demasiado largos. gallery-dl ofrece modos de restricción para Windows, Unix, ASCII y conjuntos personalizados; elige el que corresponda al equipo y revisa el resultado.
Si compartes la configuración entre sistemas, utiliza separadores conservadores y pocas carpetas. Prueba signos de puntuación, títulos ausentes, nombres no latinos y valores largos: importa la longitud de toda la ruta, no solo la del archivo.
| Caso de prueba | Por qué importa | Respuesta prudente |
|---|---|---|
| Signos reservados | Windows rechaza algunos caracteres | Activa un modo compatible y revisa la vista previa |
| Título largo | La ruta completa puede exceder el límite | Usa un ID y acorta el título |
| Campo ausente | Una clave inventada puede quedar vacía | Consulta -K y conserva una alternativa |
| Texto no latino | El sistema de archivos puede tratarlo distinto | Usa UTF-8 y prueba en el equipo final |
Elige una URL compatible y ejecuta -K. Anota los campos que usarás, prueba el patrón más corto con --simulate y revisa la salida. Después descarga un rango pequeño a un destino temporal y comprueba tanto los nombres como la jerarquía de carpetas.
Repite la prueba con otra URL representativa; incluye puntuación o un título ausente si el sitio lo permite. Cuando funcione, guarda la opción en la configuración permanente y documenta el comando probado.
Si cambia el comportamiento, usa --config-status y compáralo con --config-ignore --simulate. Conserva una copia de la configuración correcta y modifica una regla cada vez.
gallery-dl --config-ignore --simulate "URL"gallery-dl --config-statusgallery-dl --range "1-3" --filename "{id}_{title}.{extension}" "URL"Los nombres genéricos pueden indicar un campo ausente, una opción más específica que lo sustituye o una configuración distinta de la esperada. Compara -K con el patrón, consulta --config-status y ejecuta una simulación limpia antes de añadir claves.
Los archivos omitidos o sobrescritos son un problema distinto de selección. La plantilla no sustituye a --download-archive ni compara bytes. Conserva un ID e inspecciona URL, rango y filtros antes de cambiar el historial.
Ejecuta -K con esa URL, sustituye los campos supuestos y conserva una alternativa literal durante la prueba.
Acorta el patrón, elimina signos reservados y prueba en el equipo donde se ejecutará la tarea.
Las plantillas organizan descargas locales. No eluden inicios de sesión, muros de pago, límites de solicitudes, controles de acceso ni reglas de una plataforma. Prueba solo URL y medios que tengas permiso para usar y no pongas credenciales en comandos o registros.
Mantén la plantilla breve y específica del extractor. Descubre las claves con -K, simula, prueba algunos casos límite y guarda el patrón en el nivel de configuración más concreto. Documenta también el destino y el comando comprobado para poder revisar cambios posteriores.
Ejecuta gallery-dl -K "URL". El comando enumera claves para nombres y carpetas con ejemplos del extractor de esa URL. Usa esa salida como referencia.
{id}_{title}.{extension} es un buen inicio si -K muestra esos campos. Añade categoría o fecha solo después de que la prueba pequeña funcione.
Sí. extractor.directory acepta una lista de cadenas de formato y cada una crea un segmento bajo el directorio base. Prueba valores de autor y título por sus caracteres y longitud.
Las claves disponibles dependen del extractor. Ejecuta -K para cada URL y guarda los valores específicos en el nivel de configuración del sitio correspondiente.
Usa un modo de restricción compatible con Windows, separadores sencillos y un patrón corto. Prueba signos reservados, títulos largos o ausentes y la ruta completa en el equipo de destino.
No. Solo controla los nombres locales. Para recordar elementos entre ejecuciones utiliza un archivo --download-archive estable y conserva un identificador en el nombre.