Este guia do gallery-dl para Reddit mostra como escolher uma URL canônica, simular a extração, separar acesso público de OAuth, limitar o primeiro lote, evitar duplicatas e diagnosticar erros 400, 403, bloqueios e resultados vazios.
Sim, o gallery-dl tem um extrator para Reddit, mas o tipo exato de URL e as permissões da conta determinam o resultado. Comece com uma URL pública canônica e --simulate. Para áreas salvas, privadas ou ligadas à conta, configure os campos OAuth da documentação oficial em vez de repetir solicitações anônimas.
Comece pela menor URL que represente seu objetivo: um post público, um subreddit, uma página de usuário ou outro tipo reconhecido pelo extrator instalado. Copie a URL canônica da barra normal do navegador, remova parâmetros de rastreamento quando possível e coloque a URL entre aspas no shell.
--simulate verifica o extrator e a seleção sem gravar mídia. Isso separa instalação, reconhecimento da URL, acesso, configuração e destino antes que você adicione filtros, intervalos ou um arquivo de arquivo.
gallery-dl --config-ignore --simulate "https://www.reddit.com/r/SUBREDDIT/"gallery-dl --simulate "https://www.reddit.com/comments/POST_ID/"gallery-dl -E "https://www.reddit.com/r/SUBREDDIT/"gallery-dl -K "https://www.reddit.com/comments/POST_ID/"SUBREDDIT e POST_ID são exemplos. Use uma URL real que você tenha autorização para acessar e mantenha --simulate até confirmar que o escopo selecionado está correto.
A referência oficial de sites compatíveis lista o Reddit como um extrator. Isso não garante que toda página, pesquisa, estado de conta ou região terá o mesmo comportamento. Posts públicos e subreddits são bons pontos de partida. Itens salvos, feeds personalizados e comunidades privadas podem exigir OAuth e ter regras de acesso diferentes.
Avalie o suporte combinando tipo de URL, versão instalada, acesso da conta e capacidade do extrator. Um teste público bem-sucedido também não concede permissão para republicar o conteúdo.
Use um único post ou uma pequena visualização de subreddit para verificar URL, mídia, nomes de arquivo e destino antes de ampliar o feed.
Áreas ligadas à conta podem precisar de OAuth e continuam limitadas pelas permissões da própria conta. Não conclua que o conteúdo privado ou salvo é compatível só porque um post público funcionou.
Uma página do Reddit pode conter imagens, galerias, links de vídeo, texto, prévias e itens excluídos ou inacessíveis. Revise a seleção simulada antes de aumentar o trabalho.
| Objetivo | Primeiro teste | Por que importa |
|---|---|---|
| Um post público | --simulate URL | Separa reconhecimento da URL da gravação |
| Feed de subreddit | --simulate --range 1-10 URL | Mantém o primeiro resultado pequeno |
| Conteúdo de conta | Configuração OAuth oficial | Usa o acesso da conta que você controla |
| Nome de arquivo ou filtros | -K URL | Mostra os campos antes das expressões |
O acesso anônimo não substitui de forma confiável o conteúdo do Reddit ligado a uma conta. Quando o extrator exigir OAuth, crie ou use as credenciais de aplicativo descritas na documentação oficial de configuração do gallery-dl, mantenha o client secret privado e forneça um user-agent claro. A configuração usa uma conta e um aplicativo que você controla; não serve para contornar uma restrição.
Separe o primeiro teste público da autenticação. Primeiro confirme que a versão instalada reconhece uma URL pública; depois acrescente a configuração OAuth mínima e teste a URL exata da conta com --simulate. Se falhar, confira ID, secret, user-agent e permissão da conta um de cada vez.
{
"extractor": {
"reddit": {
"client-id": "YOUR_CLIENT_ID",
"client-secret": "YOUR_CLIENT_SECRET",
"user-agent": "gallery-dl/1.32.9 by YOUR_USERNAME"
}
}
}gallery-dl --simulate "https://www.reddit.com/user/USERNAME/saved/"gallery-dl --config-ignore --simulate "https://www.reddit.com/r/SUBREDDIT/"Client secrets, tokens, identificadores de conta, dados do navegador e logs sem redigir podem conceder acesso. Use marcadores nos exemplos e guarde os valores reais apenas no dispositivo que executa o gallery-dl.
Depois de uma simulação bem-sucedida, escolha um destino previsível e faça o primeiro download real de propósito pequeno. Um intervalo permite revisar nomes de arquivo, qualidade, vídeos, posts ausentes e armazenamento antes de ampliar o feed. Para trabalhos repetidos, use um arquivo de arquivo estável; ele registra IDs extraídos com sucesso, mas não é um backup da mídia.
Mova as opções para uma configuração somente depois que o comando funcionar. Use -K para consultar metadados antes de criar expressões de nome ou filtro e mantenha destinos, arquivos de arquivo e valores da conta fora de snippets públicos.
gallery-dl --range "1-10" --download-archive "reddit.sqlite3" "https://www.reddit.com/r/SUBREDDIT/"gallery-dl --destination "D:/Media/Reddit" --download-archive "reddit.sqlite3" "https://www.reddit.com/r/SUBREDDIT/"gallery-dl --write-metadata --download-archive "reddit.sqlite3" "https://www.reddit.com/r/SUBREDDIT/"| Objetivo | Opção | Por que importa |
|---|---|---|
| Testar sem arquivos | --simulate | Confere extrator, acesso e seleção primeiro |
| Limitar o primeiro lote | --range 1-10 | Facilita revisar saída e armazenamento |
| Evitar duplicatas futuras | --download-archive FILE | Mantém os IDs bem-sucedidos |
| Definir uma pasta base | --destination DIR | Separa o trabalho de outros downloads |
| Consultar campos disponíveis | -K URL | Evita filtros supostos que excluem tudo |
Não trate toda falha do Reddit como falta de uma opção. Um erro 400 pode vir de uma URL inválida ou alterada, OAuth incompleto ou uma requisição que o extrator deixou de montar. Um 403 ou bloqueio pode refletir acesso da conta, limite de requisições, política da plataforma, região ou mudança no extrator. Pare as tentativas repetidas, confirme a URL no navegador normal e execute uma simulação limpa.
Um resultado vazio também pode ser causado por filtro restritivo, arquivo que já contém os IDs, conteúdo excluído ou um tipo de URL sem mídia acessível. Compare com --config-ignore e sem filtro; depois reintroduza OAuth, intervalo, arquivo, destino e filtro um por vez.
| Sintoma | Primeiro teste | Próximo passo seguro |
|---|---|---|
| 400 Bad Request | URL canônica, OAuth e versão | Simulação limpa e notas oficiais |
| 403 ou bloqueado | Acesso no navegador e estado do limite | Pare, aguarde ou reduza o escopo |
| Nenhum extrator | Linha de sites compatíveis e caminho exato | Tente uma URL pública canônica |
| Nenhum arquivo selecionado | --config-ignore sem filtro | Verifique URL, acesso, metadados e intervalo |
| Tudo ignorado | Caminho e conteúdo do arquivo | Use um arquivo de diagnóstico separado se necessário |
| Erro de OAuth | ID, secret, user-agent e permissão | Altere um campo de cada vez |
O gallery-dl é um baixador local, não um sistema de permissões. Baixe e use apenas conteúdo que você esteja autorizado a acessar e utilizar. Respeite regras do Reddit, comunidades, privacidade, direitos autorais, permissões da conta e limites de requisição. Uma URL acessível não é automaticamente uma licença para republicar, e OAuth não amplia as permissões da conta.
Na verificação de atualização desta página em 10 de agosto de 2026, o site conferiu o gallery-dl 1.32.9 nos metadados oficiais do PyPI e nos arquivos Windows e Linux da release do Codeberg. Execute gallery-dl --version e consulte a documentação oficial novamente quando um comando antes funcional mudar.
A referência oficial de sites compatíveis lista o Reddit como extrator. A versão instalada, o tipo de URL, o acesso da conta, a região e o comportamento atual da plataforma ainda determinam o resultado, então simule a URL exata primeiro.
Comece com uma URL pública canônica entre aspas e execute gallery-dl --config-ignore --simulate URL. Se a seleção estiver correta, acrescente um pequeno intervalo, um destino local e um arquivo de download estável.
Testes de URLs públicas podem funcionar sem credenciais, mas áreas salvas, privadas ou ligadas à conta podem exigir OAuth. Use os campos oficiais, mantenha o secret privado e teste a URL exata com --simulate.
Confira a URL canônica, a versão instalada, os campos OAuth e o user-agent. Compare com --config-ignore --simulate, pare as tentativas repetidas e consulte a configuração oficial antes de alterar filtros.
Permissões da conta, limites, política da plataforma, comportamento regional ou mudança do extrator podem causar isso. Confirme o acesso normal, reduza o escopo, aguarde e não tente contornar controles de acesso.
Verifique tipo de URL, extrator, acesso, filtros, intervalo, conteúdo excluído e arquivo. Compare a mesma URL com --config-ignore e sem filtro, depois reative uma configuração por vez.
Use --download-archive com um caminho local estável. O gallery-dl registra IDs extraídos com sucesso e ignora correspondências em execuções futuras; o arquivo não é backup da mídia.
A versão verificada nesta página em 10 de agosto de 2026 é o gallery-dl 1.32.9, com base nos metadados oficiais do PyPI e nos arquivos upstream. Confira gallery-dl --version e a release oficial antes de depender de um comportamento sensível à versão.