O suporte a gallery-dl Tumblr fica mais claro quando você separa o alcance da URL, o acesso e o controle de execuções repetidas. Este guia mostra como testar um blog público, baixar uma tag ou publicação específica, adicionar cookies somente quando necessário e manter um arquivo local previsível.
URLs de blogTags e buscaCookiesArquivos sem duplicatas
Um fluxo específico para Tumblr começa com um teste pequeno e termina em um arquivo local revisado.Resposta rápida
Use como entrada uma URL pública de blog, tag, publicação ou busca do Tumblr. Comece com gallery-dl --simulate para ver o resultado sem gravar arquivos e depois repita a mesma URL com escopo pequeno e destino conhecido. Adicione cookies do navegador apenas se o Tumblr exigir uma sessão autenticada e mantenha um arquivo de histórico quando pretende repetir o trabalho.
Escopo
O que o gallery-dl Tumblr processa
O extractor do gallery-dl Tumblr foi criado para URLs em formato de blog, e não para um único endpoint genérico de imagens. Ele reconhece blogs do Tumblr, subdomínios personalizados, links de publicações e caminhos de coleção. Também trata posts de foto, vídeo, áudio, citação, link, resposta, chat e resultados de busca. Um blog pode misturar texto e mídia, enquanto seu objetivo pode ser guardar apenas um tipo.
Pense no gallery-dl Tumblr como um fluxo de arquivamento controlado. A URL define o escopo, o extractor transforma o escopo em mensagens e mídias, e a configuração decide pastas, nomes e itens já conhecidos. O comando não dá acesso a posts privados, não contorna login e não decide se você pode guardar o trabalho de outra pessoa.
Esta página é mais específica que a lista de sites compatíveis e mais focada que o guia geral de uso. As páginas ligadas cobrem instalação, exportação de cookies, palavras-chave para nomes e manutenção de arquivos; aqui ficam as decisões próprias do Tumblr.
Modelo mental útil
Trate uma URL do Tumblr como o limite da consulta. A URL de blog pode ser ampla, a de tag temática, a de post serve para uma checagem e a de busca muda com o tempo. Defina esse limite antes de acrescentar paginação, filtros ou um arquivo de longa duração.
O escopo da URL define o que o extractor encontra.
A simulação confirma o que seria encontrado.
A configuração controla caminhos, nomes, pausas e arquivos.
Permissões e regras do Tumblr continuam valendo.
Escolha da URL
Escolha o tipo certo de URL do Tumblr
Comece com a menor URL que responde à sua pergunta. Uma URL de post verifica se um item específico pode ser analisado. Uma URL de blog serve para acompanhar a mídia de um autor. Uma URL de tag ou busca é mais ampla e menos estável, pois resultados novos podem aparecer. Ao copiar uma URL do celular, remova parâmetros de rastreamento somente depois de confirmar que o escopo continua igual.
Blogs do Tumblr podem aparecer de várias formas. `tumblr.com/blog/nome`, `nome.tumblr.com` e um permalink podem apontar para o mesmo blog, mas não são igualmente práticos para um teste. Prefira a forma curta e próxima da canônica e anote a URL original.
Nem toda imagem visível em um tema é um post baixável. Avatares, recomendações, embeds externos e recursos decorativos podem aparecer juntos. Confira IDs, URLs de mídia e tipos de post na simulação antes de escrever um filtro.
Escopo
Primeiro uso
Cuidado principal
Post único
Checar parser e permissão
Pode não ter mídia baixável
Blog
Arquivo de autor ou coleção
Pode ficar grande
Tag
Amostra de assunto
Resultados mudam
Busca
Descobrir candidatos
Difícil de repetir
Subdomínio
Fluxo direto de blog
Confirmar que pertence ao Tumblr
Comece com uma URL
A simulação de um post oferece evidência mais clara que um comando grande misturando recursos do tema, reblogs e resultados não relacionados.
Primeira execução
Instale e faça um primeiro teste seguro
Instale o gallery-dl com o método que combina com seu ambiente Python ou de pacotes. O guia de instalação explica as opções; quando `gallery-dl --version` responder, mantenha pequena a primeira execução no Tumblr. A simulação mostra mensagens do extractor sem salvar mídia e revela URL errada, tela de login ou escopo amplo antes da escrita.
Use um formato de comando como os exemplos e troque a URL por um destino público que você pode consultar. A saída é evidência para a próxima decisão, não uma garantia de que todo post terá arquivo.
Quando a simulação estiver correta, escolha uma pasta de teste vazia e repita sem `--simulate`. Separe o destino de um arquivo existente para comparar mensagens e arquivos e poder remover o teste sem tocar na coleção principal.
Um trabalho repetível no Tumblr escolhe a URL, simula o resultado e arquiva uma amostra pequena.
Leia a saída da simulação
Procure o nome do extractor, o blog ou ID do post, URLs de mídia e avisos de autenticação. Um resultado vazio não é motivo para adicionar cookies imediatamente. Confirme primeiro o formato da URL, a visibilidade do blog e se a versão instalada entende a resposta atual do site.
Use `--verbose` para diagnosticar uma URL nova e remova no uso normal.
Baixar um blog é comum, mas não deve ser o início de toda tarefa. Para uma imagem específica, use o post. Para um tema, use uma tag com intervalo pequeno. Para explorar, use a busca para descobrir posts e depois transforme os resultados úteis em tarefas de post ou blog que possam ser repetidas.
O extractor pode encontrar mais do que fotos. Posts de vídeo e áudio podem funcionar de outra forma; posts de texto, citação ou resposta podem não produzir arquivo; reblogs podem trazer metadados indesejados no nome. Veja os tipos na simulação antes de criar um filtro.
Para um blog grande, divida a tarefa em pontos de controle. Rode um primeiro intervalo, confira pasta e arquivo de histórico e só então amplie. Se houver erro de rede, nomes estáveis e histórico permitem retomar sem considerar tudo que já foi visto como novo.
Sequência prática
Valide primeiro um post, depois o escopo do blog ou tag. Decida sobre cookies, acrescente destino e histórico e só repita quando a amostra fizer sentido. Assim você separa problemas de análise e acesso.
Post: conferir um item.
Blog: arquivo de autor ou coleção.
Tag: amostra temática limitada.
Busca: descoberta, não chave de arquivo imutável.
O que é um bom resultado
Um bom resultado é explicável: URL de origem, quantidade plausível, tipos incluídos e pasta conhecida. Muitos arquivos sem repetibilidade ou auditoria formam um fluxo arriscado.
Repetição
Controle configuração, nomes e arquivos
Depois de entender o teste, coloque escolhas estáveis na configuração do gallery-dl. Ela pode definir diretório do Tumblr, campos do nome, arquivo de downloads e uma pausa moderada. Centralizar essas escolhas reduz diferenças entre execução manual e agendada.
Um nome de arquivo do Tumblr deve mostrar blog, post ou ID e o número que distingue várias mídias. Use o guia de modelos para descobrir palavras-chave em vez de adivinhar. Se um campo não existir para certo tipo de post, use um fallback legível.
O arquivo de histórico registra IDs processados; não substitui backup da mídia. Guarde-o com a configuração, faça cópia e não o publique se revelar dados de URL. Depois de mudar pasta ou padrão, mantenha o mesmo histórico somente se quiser ignorar os mesmos itens lógicos.
Mudar a pasta não muda a identidade do histórico. Decida se o mesmo post deverá continuar sendo ignorado antes de mover arquivos.
Acesso
Use cookies somente quando o Tumblr exigir
Páginas públicas do Tumblr devem ser o primeiro teste. Se o navegador vê a página mas o gallery-dl retorna erro de acesso, pode faltar cookie de sessão, consentimento ou uma resposta diferente após o carregamento. O helper de cookies explica a exportação local; passe o arquivo pela opção do gallery-dl em vez de colar valores em comando ou issue pública.
Cookies não tornam página privada pública e não garantem direito de arquivamento. Eles expiram, refletem permissões da conta e podem expor acesso quando copiados. Proteja o arquivo, deixe-o fora de pastas públicas e apague depois do teste.
Quando um comando com cookie falhar, compare com uma simulação pública. Se a pública também falhar, a causa provavelmente é URL, versão, rede ou ritmo, e não autenticação.
Lista de acesso cuidadosa
Confirme a URL pública, exporte apenas os cookies necessários, simule um post, não faça commit do arquivo e remova a sessão quando não precisar mais.
Nunca cole cabeçalhos de cookies em tutorial, log ou issue.
Não publique conteúdo autenticado sem permissão.
Use o menor escopo autenticado que resolva a tarefa.
Controle
Adicione filtros, pausas e limites responsáveis
Um arquivo do Tumblr fica mais fácil de cuidar quando o comando descreve o objetivo. Use intervalo para a primeira amostra, filtro de data ou post quando os metadados permitirem e condição de tipo se conteúdo misto não for útil. Confirme cada condição na simulação, pois um filtro sem correspondência parece um extractor quebrado.
Uma pausa curta, intervalo moderado e condição de parada protegem seu fluxo e o serviço. Se o Tumblr devolver limite ou erro temporário, pare, guarde os registros e tente mais tarde com escopo menor. Não tente contornar bloqueio trocando contas ou enviando requisições agressivas.
A capacidade de salvar um arquivo não é permissão para republicá-lo. Verifique condições do autor, políticas do Tumblr e licença ou copyright. Mantenha material privado ou sensível fora de arquivos públicos e registre a URL de origem quando a proveniência importar.
Controle
Ajuda
Verificar
Intervalo pequeno
Limita a primeira escrita
Intervalo bate com a ordem esperada
Tipo de post
Evita conteúdo irrelevante
Simulação mostra correspondência
Pausa
Reduz picos
Execução continua viável
Histórico
Ignora IDs conhecidos
Caminho estável e copiado
Destino separado
Protege coleção
Pasta de teste descartável
Recuperação
Resolva falhas comuns do Tumblr
Classifique a falha antes de mudar o comando. 404 ou resultado vazio pode ser URL copiada incorretamente, blog movido ou caminho não suportado. 403 ou login aponta para acesso, consentimento, cookies ou política. Timeout ou 429 aponta para ritmo, rede ou limite temporário. Cada grupo precisa de uma correção diferente.
Para problema de URL, abra a página no navegador, copie um endereço canônico e teste um post com `--simulate --verbose`. Para acesso, compare post público e sessão autenticada e use o helper de cookies apenas quando a comparação indicar. Para limite, pare, espere, reduza o intervalo e evite tarefas paralelas. Para quantidade inesperada, examine tipos, reblogs, recursos do tema e filtros antes de apagar o histórico.
Guarde a mensagem de erro original ao pedir ajuda. Informe versão do gallery-dl, sistema operacional, comando sem segredos, formato da URL sem tokens privados e se uma simulação pública funciona. Nunca anexe cookies ou mídia privada.
Separe URL, acesso e limite antes de mudar configuração ou credenciais.
Ordem rápida de diagnóstico
Confira a URL, teste um post, compare acesso público e autenticado e só então mude filtros ou saída. Essa ordem impede que uma falha de formato vire um experimento confuso.
URL: caminho canônico, blog, ID e redirecionamento.
Acesso: visibilidade, consentimento, cookies e conta.
Espera: 403/429, timeout, pausa e janela de tentativa.
Saída: pasta, campos de nome, histórico e duplicatas.
Perguntas
Perguntas frequentes do gallery-dl Tumblr
As respostas abaixo tratam decisões para um trabalho repetível no Tumblr. Os guias relacionados oferecem detalhes gerais quando o problema não é específico da plataforma.
Perguntas frequentes
Perguntas do gallery-dl Tumblr
O gallery-dl consegue baixar um blog inteiro do Tumblr?
Ele pode processar uma URL pública compatível, mas comece com simulação e intervalo pequeno. Um blog pode ter muitos tipos, reblogs e histórico; use destino estável e arquivo antes de ampliar.
Uso URL de blog ou de tag do Tumblr?
Use blog para autor ou coleção, tag para amostra temática e post para validar um item. Busca serve para descoberta, pois o resultado muda.
Por que gallery-dl Tumblr retorna resultado vazio?
Confira formato da URL, visibilidade, versão e saída de simulação. Pode ser caminho errado, estado não suportado, filtro sem correspondência ou necessidade de acesso.
Preciso de cookies para downloads do Tumblr?
Não em toda página pública. Use somente quando comparação pública e erro mostrarem que uma sessão é necessária. Proteja o arquivo; cookies não dão direito a conteúdo privado.
Como evitar o mesmo post do Tumblr duas vezes?
Configure um histórico estável e mantenha-o com o trabalho. Teste mudanças de pasta ou nome separadamente para saber quais IDs são ignorados.
O que faço depois de 429 ou timeout no Tumblr?
Pare, guarde o log, espere, reduza o intervalo e repita com pausa moderada. Evite tentativas paralelas e troca de contas para contornar limite.