ENCUENTRA TUS DESCARGAS

Plantillas de nombres de archivo de gallery-dl: nombres, carpetas y metadatos

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.

Nombres basados en metadatosCarpetas previsiblesPruebas seguras
Ilustración editorial de una terminal que organiza archivos con metadatos en carpetas
Una plantilla conecta los campos del extractor con una estructura local que puedes repetir.
Respuesta breve: inspecciona y después formatea

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.

DEFINE EL RESULTADO

Qué controlan las plantillas de nombres de gallery-dl

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.

DESCUBRE LOS CAMPOS REALES

Consulta las claves disponibles con -K

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.

Diagrama editorial que muestra cómo los metadatos inspeccionados se convierten en un nombre de archivo
La salida de -K es la lista de campos para diseñar una plantilla de ese extractor.
Listar campos para una URL
gallery-dl -K "URL"
Simular la extracción sin descargar
gallery-dl --simulate "URL"
CREA UN NOMBRE LEGIBLE

Crea un formato de nombre de archivo para gallery-dl

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.

Prueba puntual del nombre
gallery-dl --filename "{category}_{id}_{title}.{extension}" --simulate "URL"
Configuración específica del extractor
{
  "extractor": {
    "example": {
      "filename": "{id}_{title}.{extension}"
    }
  }
}
Idea de patrónCuándo resulta útilQué comprobar
{id}_{extension}Los títulos faltan o cambianQue el extractor muestre un ID estable
{date}_{id}_{title}Exploras por fechaQue la fecha tenga un formato previsible
{author}/{title}Cada creador tiene su carpetaQue el autor sea válido como ruta
{category}_{id}_{title}.{extension}Compartes una carpeta raíz entre sitiosQue categoría y extensión aparezcan en -K
SEPARA LAS COLECCIONES

Organiza carpetas con plantillas de directorio

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.

Agrupar por sitio y autor
{
  "extractor": {
    "example": {
      "directory": ["{category}", "{author}"],
      "filename": "{id}_{title}.{extension}"
    }
  }
}
DISTINGUE LOS FORMATOS

Añade formatos condicionales con cuidado

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.

Separar nombres de vídeo
{
  "extractor": {
    "example": {
      "filename": {
        "extension == 'mp4'": "{id}_video.{extension}",
        "": "{id}_{title}.{extension}"
      }
    }
  }
}
MANTÉN LA COMPATIBILIDAD

Comprueba los límites de nombres en Windows, Linux y macOS

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.

Ilustración de una ruta que supera una lista de comprobación multiplataforma antes de llegar a carpetas del sistema
La revisión multiplataforma incluye caracteres, longitud y destino final.
Caso de pruebaPor qué importaRespuesta prudente
Signos reservadosWindows rechaza algunos caracteresActiva un modo compatible y revisa la vista previa
Título largoLa ruta completa puede exceder el límiteUsa un ID y acorta el título
Campo ausenteUna clave inventada puede quedar vacíaConsulta -K y conserva una alternativa
Texto no latinoEl sistema de archivos puede tratarlo distintoUsa UTF-8 y prueba en el equipo final
COMPRUEBA EL RESULTADO

Flujo seguro para validar una plantilla de gallery-dl

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.

Comparación sin configuración
gallery-dl --config-ignore --simulate "URL"
Consultar configuración activa
gallery-dl --config-status
Primera descarga pequeña
gallery-dl --range "1-3" --filename "{id}_{title}.{extension}" "URL"
AISLA EL PROBLEMA

Soluciona nombres vacíos, repetidos o rutas no válidas

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.

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

El sistema rechaza la ruta

Acorta el patrón, elimina signos reservados y prueba en el equipo donde se ejecutará la tarea.

  • Revisa caracteres
  • Revisa longitud total
  • Prueba valores no latinos
Haz pruebas autorizadas y reproducibles

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 EL TRABAJO CLARO

Una rutina de nombres fácil de mantener

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.

Preguntas frecuentes

Preguntas frecuentes sobre plantillas de nombres de gallery-dl

¿Cómo veo qué campos admite gallery-dl en un nombre?

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.

¿Cuál es un formato sencillo de nombre para gallery-dl?

{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.

¿Puedo crear carpetas con metadatos de gallery-dl?

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.

¿Por qué funciona la plantilla en un sitio pero no en otro?

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.

¿Cómo hago que los nombres funcionen en Windows?

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.

¿Una plantilla evita descargas duplicadas?

No. Solo controla los nombres locales. Para recordar elementos entre ejecuciones utiliza un archivo --download-archive estable y conserva un identificador en el nombre.

Referencias oficiales

Documentación oficial de configuración de gallery-dlOpciones oficiales de línea de comandosCódigo e incidencias de gallery-dl
SIGUIENTE PASO

Recursos relacionados