Windows 11/10  ·  Configuração JSON  ·  Exemplos para copiar

Arquivo de Configuração gallery-dl no Windows — Guia de Configuração

O arquivo de configuração do gallery-dl permite definir padrões permanentes — pasta de saída, modelos de nome de arquivo, rate limiting, cookies e opções por site. Sem precisar repetir flags em cada comando.

Local do arquivo de configuração

Onde o gallery-dl procura o arquivo de configuração no Windows?

O gallery-dl verifica esses locais em ordem — o primeiro encontrado é usado.

Prioridade 1
%APPDATA%\gallery-dl\config.json

ex: C:\Users\SeuNome\AppData\Roaming\gallery-dl\config.json — recomendado para configuração permanente

Prioridade 2
gallery-dl.conf (mesma pasta do gallery-dl.exe)

Configuração portátil — viaja com o executável

Flag CLI
gallery-dl --config "C:\caminho\para\meuconfig.json" "URL"

Substituir caminho de configuração por comando

Dica: Crie a pasta %APPDATA%\gallery-dl\ se não existir. Pressione Win+R, digite %APPDATA%, pressione Enter, depois crie uma nova pasta chamada gallery-dl.

Configuração inicial

Configuração gallery-dl recomendada para Windows — copie e cole

Salve como config.json em %APPDATA%\gallery-dl\. Edite os caminhos e opções conforme necessário.

gallery-dl.conf — configuração inicial recomendada para Windows
{ "extractor": { "base-directory": "C:/Imagens/", "filename": "{category}_{author}_{num:>04}_{filename}.{extension}", "sleep-request": 1.5, "retries": 5, "timeout": 30, "verify": true }, "downloader": { "part": true, "rate": "2M" }, "output": { "mode": "terminal", "progress": true, "shorten": true } }
Nota: JSON requer aspas duplas e sem vírgulas no final. Use barras normais / nos caminhos — funcionam bem no Windows e evitam problemas de escape com barras invertidas.

Opções principais explicadas

Opções de configuração mais úteis do gallery-dl para Windows

Definir pasta de download — aplica a todos os sites
"base-directory": "C:/Imagens/"
Modelo de nome de arquivo personalizado — categoria + autor + número + nome original
"filename": "{category}_{author}_{num:>04}_{filename}.{extension}"
Pasta de saída por site — Instagram em subpasta própria
"directory": ["{category}", "{uploader}"]
Reduzir velocidade de requisições para evitar rate limiting (segundos entre requisições)
"sleep-request": 2.0
Limitar velocidade de download (útil em conexões compartilhadas)
"rate": "2M"
Definir arquivo de cookies para um site específico (exemplo Instagram)
"instagram": { "cookies": "C:/Tools/gallery-dl/instagram-cookies.txt" }

Modelos de nome de arquivo

Variáveis de modelo de nome de arquivo do gallery-dl — Windows

Use essas variáveis nas configurações "filename" e "directory".

{filename}
Nome de arquivo original
{extension}
Extensão do arquivo (jpg, png…)
{category}
Nome do site (instagram, twitter…)
{author}
Nome do autor/uploader
{uploader}
Nome de usuário/handle
{num}
Número sequencial
{date}
Data da postagem
{title}
Título da postagem (se disponível)
{id}
ID da postagem/imagem

Números com zeros: {num:>04} → 0001, 0042. Formato de data: {date:%Y-%m-%d} → 2026-06-09.

Perguntas Frequentes

Configuração gallery-dl — perguntas frequentes

Onde fica o arquivo de configuração do gallery-dl no Windows?
O local padrão é %APPDATA%\gallery-dl\config.json. Abra Executar (Win+R), digite %APPDATA%\gallery-dl e pressione Enter para navegar diretamente. Você também pode colocar gallery-dl.conf na mesma pasta do gallery-dl.exe para configuração portátil.
gallery-dl diz "arquivo de configuração não encontrado" — como resolver?
O gallery-dl não requer um arquivo de configuração — funciona sem um. Se quiser criar um: crie a pasta %APPDATA%\gallery-dl\ e salve seu arquivo JSON lá como config.json. Verifique se é JSON válido — qualquer vírgula ou aspas faltando vai quebrar tudo.
Como valido minha configuração JSON do gallery-dl?
Cole sua configuração em jsonlint.com para verificar erros de sintaxe. Erros comuns: vírgulas no final do último item, aspas simples em vez de duplas, e barras invertidas do Windows nos caminhos (use barras normais ou escape como \\).
Posso ter configurações diferentes para sites diferentes?
Sim. Coloque configurações específicas por site sob a chave do nome do site. Exemplo: "instagram": {"sleep-request": 3} dentro do objeto "extractor". As chaves de site correspondem à variável {category} — instagram, twitter, pixiv, deviantart, reddit, etc.
Como defino uma pasta de download diferente por site?
Use a opção "directory" por extractor de site. Exemplo: "instagram": {"directory": ["C:/Insta/", "{uploader}"]}. Isso cria automaticamente uma subpasta por nome de usuário.