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
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.
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.
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.
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.
gallery-dl -K "URL"gallery-dl --simulate "URL"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.
gallery-dl --filename "{category}_{id}_{title}.{extension}" --simulate "URL"{
"extractor": {
"example": {
"filename": "{id}_{title}.{extension}"
}
}
}| Ideia de padrão | Útil quando | O que conferir |
|---|---|---|
| {id}_{extension} | Os títulos faltam ou mudam | Se o extrator fornece um ID estável |
| {date}_{id}_{title} | Você organiza por data | Se a data tem um formato previsível |
| {author}/{title} | Cada criador deve ter uma pasta | Se o autor é seguro como parte do caminho |
| {category}_{id}_{title}.{extension} | Vários sites usam a mesma pasta raiz | Se category e extension aparecem em -K |
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.
{
"extractor": {
"example": {
"directory": ["{category}", "{author}"],
"filename": "{id}_{title}.{extension}"
}
}
}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.
{
"extractor": {
"example": {
"filename": {
"extension == 'mp4'": "{id}_video.{extension}",
"": "{id}_{title}.{extension}"
}
}
}
}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.
| Caso de teste | Por que importa | Resposta prudente |
|---|---|---|
| Pontuação reservada | O Windows rejeita alguns caracteres | Escolha um modo compatível e confira a prévia |
| Título longo | O caminho completo pode exceder o limite | Mantenha o ID e encurte o título |
| Campo ausente | Uma chave presumida pode ficar vazia | Confira -K e mantenha uma alternativa |
| Texto não latino | O sistema de arquivos pode tratá-lo de outra forma | Use UTF-8 e teste na máquina final |
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.
gallery-dl --config-ignore --simulate "URL"gallery-dl --config-statusgallery-dl --range "1-3" --filename "{id}_{title}.{extension}" "URL"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.
Execute -K para essa URL, substitua campos presumidos e mantenha um valor literal de alternativa durante o teste.
Encurte o modelo, remova caracteres reservados e teste na máquina que executará o trabalho.
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 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.
Execute gallery-dl -K "URL". O comando lista as chaves de nome e pasta com exemplos do extrator associado à URL.
{id}_{title}.{extension} é um bom começo se esses campos aparecerem em -K. Acrescente categoria ou data depois que um teste pequeno funcionar.
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.
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.
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.
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.