ENCONTRE SEUS ARQUIVOS

Modelos de nome de arquivo do gallery-dl: nomes, pastas e metadados

Os modelos de nome de arquivo do gallery-dl transformam metadados do extrator em nomes e caminhos previsíveis. Veja como descobrir os campos disponíveis para uma URL, criar um formato simples, lidar com caracteres incompatíveis e conferir o resultado antes de processar uma coleção inteira.

Nomes com metadadosPastas previsíveisTeste seguro
Ilustração editorial de um terminal organizando arquivos com metadados em pastas
Um modelo liga os campos do extrator a uma estrutura local que pode ser repetida.
Resposta rápida: confira os campos antes de formatar

Execute gallery-dl -K "URL" para ver as chaves de substituição oferecidas pelo extrator. Use-as em --filename ou extractor.filename e defina segmentos de pasta com extractor.directory. Confira o resultado usando --simulate e uma URL pequena antes de salvar uma configuração permanente. Uma chave disponível em um extrator pode não existir em outro.

COMECE PELO RESULTADO

O que os modelos de nome do gallery-dl controlam

Um modelo de nome é uma cadeia de formato que o gallery-dl avalia ao preparar um arquivo. Ela pode combinar metadados do extrator, como ID, título, data, autor, número da página ou extensão, com separadores fáceis de ler. As pastas seguem a mesma ideia: cada segmento pode usar um valor de metadado para organizar uma coleção por site, criador ou série.

O modelo altera a organização local, não a URL nem a decisão de download do extrator. Comece com um padrão curto, único, legível e aceito pelas máquinas que executarão o trabalho.

DESCUBRA OS CAMPOS REAIS

Consulte as chaves disponíveis com -K

A documentação oficial recomenda -K ou --list-keywords com uma URL específica. O comando mostra as chaves para pastas e nomes de arquivo, acompanhadas por valores de exemplo. Essa saída define os limites do modelo: ela informa o que o extrator usado fornece, sem depender de variáveis supostas, de outra plataforma ou de um tutorial antigo.

Escolha uma URL pública que você tenha permissão para acessar e faça uma verificação pequena. Se o site exigir autenticação, resolva isso separadamente pelo fluxo normal de login e pelos cookies locais do navegador. Não copie cookies ou tokens privados para modelos, chamados de suporte ou registros compartilhados.

Diagrama editorial mostrando campos de metadados sendo conferidos e combinados no nome de um arquivo
A saída de -K é a lista de campos para o modelo daquele extrator.
Listar campos para uma URL
gallery-dl -K "URL"
Simular a extração sem baixar
gallery-dl --simulate "URL"
CRIE UM NOME LEGÍVEL

Monte um formato de nome de arquivo no gallery-dl

Comece com um identificador estável e adicione apenas os campos úteis para encontrar o arquivo depois. Um padrão como {category}_{id}_{title}.{extension} é fácil de reconhecer; uma data no início ajuda na ordenação cronológica. Os campos disponíveis dependem do extrator, então confira cada um com -K.

Use --filename em um teste pontual. Depois de uma simulação e uma pequena execução real, mova o padrão para a seção JSON do extrator correspondente. Um valor mais específico pode substituir uma configuração geral.

Prefira separadores claros e mantenha a extensão no final. Preserve um identificador para itens que não tenham título.

Teste pontual do nome
gallery-dl --filename "{category}_{id}_{title}.{extension}" --simulate "URL"
Configuração específica do extrator
{
  "extractor": {
    "example": {
      "filename": "{id}_{title}.{extension}"
    }
  }
}
Ideia de padrãoÚtil quandoO que conferir
{id}_{extension}Os títulos faltam ou mudamSe o extrator fornece um ID estável
{date}_{id}_{title}Você organiza por dataSe a data tem um formato previsível
{author}/{title}Cada criador deve ter uma pastaSe o autor é seguro como parte do caminho
{category}_{id}_{title}.{extension}Vários sites usam a mesma pasta raizSe category e extension aparecem em -K
SEPARE AS COLEÇÕES

Organize pastas com modelos de diretório

A opção extractor.directory aceita uma lista de cadeias de formato. Cada item se torna um segmento do caminho, acrescentado abaixo do diretório base. Assim, você define claramente uma estrutura por site, autor e coleção, sem concentrar tudo em um nome de arquivo longo.

Use os modelos de diretório quando as pastas ajudarem o seu fluxo de trabalho. Teste valores de autor e título para encontrar separadores, caracteres reservados ou textos longos. Não inclua segredos ou nomes de contas privadas em um caminho que será compartilhado.

Agrupar por site e autor
{
  "extractor": {
    "example": {
      "directory": ["{category}", "{author}"],
      "filename": "{id}_{title}.{extension}"
    }
  }
}
TRATE MÍDIAS DIFERENTES

Adicione formatos condicionais com cuidado

A configuração pode associar condições a diferentes cadeias de nome. As condições são avaliadas na ordem escrita, e a primeira verdadeira é usada. Uma entrada vazia ou o padrão do extrator pode servir de alternativa. Isso ajuda quando uma coleção mistura vídeos e imagens.

Condições são mais difíceis de depurar do que uma cadeia simples. Adicione uma de cada vez e teste URLs que correspondem e que não correspondem. Mantenha clara a alternativa e use somente campos listados por -K.

Separar nomes de vídeos
{
  "extractor": {
    "example": {
      "filename": {
        "extension == 'mp4'": "{id}_video.{extension}",
        "": "{id}_{title}.{extension}"
      }
    }
  }
}
MANTENHA OS NOMES COMPATÍVEIS

Confira os limites de nomes no Windows, Linux e macOS

Um modelo válido ainda pode gerar um caminho rejeitado pelo sistema operacional. Títulos podem conter caracteres reservados ou ser muito longos. O gallery-dl oferece modos de restrição para Windows, Unix, ASCII e conjuntos personalizados; escolha o adequado às máquinas do trabalho e examine o resultado.

Se a mesma configuração for usada em sistemas diferentes, adote separadores simples e poucas camadas de pastas. Teste pontuação, títulos ausentes, nomes não latinos e valores longos. O caminho completo, incluindo o destino, importa tanto quanto o nome do arquivo.

Ilustração de um nome de arquivo passando por uma lista de verificação antes de chegar a pastas de vários sistemas
A validação multiplataforma considera caracteres, tamanho e destino final.
Caso de testePor que importaResposta prudente
Pontuação reservadaO Windows rejeita alguns caracteresEscolha um modo compatível e confira a prévia
Título longoO caminho completo pode exceder o limiteMantenha o ID e encurte o título
Campo ausenteUma chave presumida pode ficar vaziaConfira -K e mantenha uma alternativa
Texto não latinoO sistema de arquivos pode tratá-lo de outra formaUse UTF-8 e teste na máquina final
CONFIRA O RESULTADO

Fluxo seguro para validar um modelo do gallery-dl

Escolha uma URL compatível e execute -K. Anote os campos que usará, teste o padrão mais curto com --simulate e examine a saída. Depois baixe um pequeno intervalo para um destino temporário e confira os nomes e a estrutura das pastas abrindo os arquivos.

Repita o teste com outra URL representativa e inclua um título com pontuação ou sem título, quando possível. Depois de confirmar que funciona, salve a opção na configuração permanente e registre o comando testado.

Se o comportamento mudar, consulte --config-status e compare com --config-ignore --simulate. Preserve uma configuração funcional e altere uma regra por vez.

Comparação sem configuração
gallery-dl --config-ignore --simulate "URL"
Verificar configuração ativa
gallery-dl --config-status
Primeira execução pequena
gallery-dl --range "1-3" --filename "{id}_{title}.{extension}" "URL"
ISOLE O PROBLEMA

Corrija nomes vazios, repetidos ou caminhos inválidos

Nomes genéricos podem indicar um campo ausente, uma configuração mais específica que o substituiu ou outro arquivo de configuração ativo. Compare -K com o modelo, confira --config-status e execute uma simulação ignorando a configuração.

Arquivos ignorados ou sobrescritos são outra questão de seleção. Um modelo não substitui --download-archive nem compara o conteúdo dos arquivos. Mantenha um ID e confira URL, intervalo e filtros antes de alterar o histórico.

O modelo deixa partes vazias

Execute -K para essa URL, substitua campos presumidos e mantenha um valor literal de alternativa durante o teste.

  • Confirme o extrator
  • Confira a configuração ativa
  • Teste um campo por vez

O caminho é rejeitado

Encurte o modelo, remova caracteres reservados e teste na máquina que executará o trabalho.

  • Revise os caracteres
  • Revise o tamanho total
  • Teste valores não latinos
Faça testes autorizados e reproduzíveis

Modelos organizam downloads locais. Eles não contornam login, paywalls, limites de solicitações, controles de acesso nem regras da plataforma. Teste apenas URLs e mídias que você tem permissão para acessar e mantenha credenciais fora dos comandos e registros.

MANTENHA O TRABALHO SIMPLES

Uma rotina de nomes fácil de manter

Mantenha o modelo curto e específico do extrator. Descubra as chaves com -K, simule, teste alguns casos extremos e salve o padrão no nível de configuração mais específico. Documente também o destino e o comando testado para que alterações futuras possam ser comparadas, não adivinhadas.

Perguntas frequentes

Perguntas frequentes sobre modelos de nome do gallery-dl

Como vejo quais campos o gallery-dl aceita em um nome?

Execute gallery-dl -K "URL". O comando lista as chaves de nome e pasta com exemplos do extrator associado à URL.

Qual é um formato simples de nome de arquivo no gallery-dl?

{id}_{title}.{extension} é um bom começo se esses campos aparecerem em -K. Acrescente categoria ou data depois que um teste pequeno funcionar.

Posso criar pastas com metadados do gallery-dl?

Sim. extractor.directory aceita uma lista de cadeias de formato; cada uma vira um segmento abaixo do diretório base. Teste valores de autor e título.

Por que o mesmo modelo funciona em um site e não em outro?

As chaves dependem do extrator. Execute -K para cada URL e mantenha opções específicas do site no nível correspondente da configuração.

Como deixar os nomes do gallery-dl compatíveis com Windows?

Use um modo de restrição compatível com Windows, separadores simples e um padrão curto. Teste pontuação reservada, títulos longos ou ausentes e o caminho completo.

Um modelo de nome impede downloads duplicados?

Não. Ele controla apenas os nomes locais. Para o histórico entre execuções, use um arquivo --download-archive estável e mantenha um identificador no nome.

Referências oficiais

Documentação oficial de configuração do gallery-dlOpções oficiais de linha de comando do gallery-dlCódigo-fonte e issues do gallery-dl
PRÓXIMO PASSO

Recursos relacionados