como usar gallery-dl · guia prático · Preparação

Como usar gallery-dl

Como usar gallery-dl com mais segurança: comece por uma URL compatível, uma simulação curta e uma pasta de saída verificada.

Conceitos básicosPreparaçãoVerificação
DOWNLOAD OFICIAL

Como usar gallery-dl: fluxo de download seguro

Escolha o sistema. O download começa após uma contagem de 15 segundos.

Como usar gallery-dl: fluxo de download seguro. Escolha o sistema. O download começa após uma contagem de 15 segundos. Confira o nome do arquivo e use as somas publicadas pelo projeto para verificar o download.

Versão1.32.9
Lançamento1 de agosto de 2026
FonteVersão oficial do Codeberg
LicençaGPL-2.0
Escolha um download para iniciar a contagem.

Confira o nome do arquivo e use as somas publicadas pelo projeto para verificar o download. Codeberg v1.32.9

Usar gallery-dl pela primeira vez

Execute uma URL compatível entre aspas com --simulate, confira o extractor e a saída e só depois adicione cookies, intervalos, arquivos ou configuração.

como usar gallery-dl · guia prático · Preparação

Usar gallery-dl com a primeira URL

como usar gallery-dl ajuda a preparar, verificar e executar tarefas locais de download com controle sem enviar a URL nem credenciais para este site. Na seção Conceitos básicos, comece com uma URL pública pequena e use a simulação antes de gravar arquivos. Confirme a versão instalada, o extrator reconhecido, a pasta de destino e cada opção adicionada antes de continuar.

Na seção Conceitos básicos, comece com uma URL pública pequena e use a simulação antes de gravar arquivos. Confirme a versão instalada, o extrator reconhecido, a pasta de destino e cada opção adicionada antes de continuar. Adicione cookies, filtros, intervalos ou arquivos de histórico separadamente para entender o efeito de cada alteração.

Simular primeiro
gallery-dl --simulate "https://www.example.com/gallery"
Executar o download
gallery-dl "https://www.example.com/gallery"
Inspecionar as informações do extractor
gallery-dl -E "https://www.example.com/gallery"
como usar gallery-dl · guia prático · Preparação

como usar gallery-dl: Preparação

Na seção Preparação, comece com uma URL pública pequena e use a simulação antes de gravar arquivos. Confirme a versão instalada, o extrator reconhecido, a pasta de destino e cada opção adicionada antes de continuar. Adicione cookies, filtros, intervalos ou arquivos de histórico separadamente para entender o efeito de cada alteração.

Confirme a versão instalada, o extrator reconhecido, a pasta de destino e cada opção adicionada antes de continuar. Adicione cookies, filtros, intervalos ou arquivos de histórico separadamente para entender o efeito de cada alteração. Mantenha os dados de autenticação no seu dispositivo e remova caminhos privados, contas e tokens de qualquer registro compartilhado.

Conceitos básicosPreparaçãoVerificação
como usar gallery-dl · guia prático · Preparação — Conceitos básicoscomo usar gallery-dl · guia prático · Preparação — Preparaçãocomo usar gallery-dl · guia prático · Preparação — Verificação
como usar gallery-dl · guia prático · Preparação — Preparaçãocomo usar gallery-dl · guia prático · Preparação — Verificaçãocomo usar gallery-dl · guia prático · Preparação — Privacidade
como usar gallery-dl · guia prático · Preparação — Verificaçãocomo usar gallery-dl · guia prático · Preparação — Privacidadecomo usar gallery-dl · guia prático · Preparação — Casos comuns
como usar gallery-dl · guia prático · Preparação — Privacidadecomo usar gallery-dl · guia prático · Preparação — Casos comunscomo usar gallery-dl · guia prático · Preparação — Limites e diagnóstico
como usar gallery-dl · guia prático · Preparação — Casos comunscomo usar gallery-dl · guia prático · Preparação — Limites e diagnósticocomo usar gallery-dl · guia prático · Preparação — Conceitos básicos
como usar gallery-dl · guia prático · Preparação

como usar gallery-dl: Verificação

Confirme a versão instalada, o extrator reconhecido, a pasta de destino e cada opção adicionada antes de continuar. Adicione cookies, filtros, intervalos ou arquivos de histórico separadamente para entender o efeito de cada alteração. Mantenha os dados de autenticação no seu dispositivo e remova caminhos privados, contas e tokens de qualquer registro compartilhado.

Adicione cookies, filtros, intervalos ou arquivos de histórico separadamente para entender o efeito de cada alteração. Mantenha os dados de autenticação no seu dispositivo e remova caminhos privados, contas e tokens de qualquer registro compartilhado. A documentação oficial e a saída da versão instalada são a referência final quando um site ou uma opção muda.

Cookies do Firefox
gallery-dl --cookies-from-browser firefox "URL"
Cookies do Chrome
gallery-dl --cookies-from-browser chrome "URL"
Arquivo local cookies.txt
gallery-dl --cookies "cookies.txt" "URL"
Verificação

Em tarefas recorrentes, mantenha uma configuração revisada, um caminho estável e um arquivo de downloads com cópia de segurança. Se ocorrer um erro, repita um teste limpo com --config-ignore e --simulate antes de alterar várias opções. como usar gallery-dl ajuda a preparar, verificar e executar tarefas locais de download com controle sem enviar a URL nem credenciais para este site.

como usar gallery-dl · guia prático · Preparação

como usar gallery-dl: Privacidade

Adicione cookies, filtros, intervalos ou arquivos de histórico separadamente para entender o efeito de cada alteração. Mantenha os dados de autenticação no seu dispositivo e remova caminhos privados, contas e tokens de qualquer registro compartilhado. A documentação oficial e a saída da versão instalada são a referência final quando um site ou uma opção muda.

Mantenha os dados de autenticação no seu dispositivo e remova caminhos privados, contas e tokens de qualquer registro compartilhado. A documentação oficial e a saída da versão instalada são a referência final quando um site ou uma opção muda. Em tarefas recorrentes, mantenha uma configuração revisada, um caminho estável e um arquivo de downloads com cópia de segurança.

Ignorar arquivos registrados
gallery-dl --download-archive "archive.sqlite3" "URL"
Baixar um intervalo
gallery-dl --range "1-50" "URL"
Filtrar um período de datas
gallery-dl --date-after 2026-01-01 --date-before 2026-07-01 "URL"
Escrever metadados
gallery-dl --write-metadata "URL"
como usar gallery-dl · guia prático · Preparação

como usar gallery-dl: Casos comuns

Mantenha os dados de autenticação no seu dispositivo e remova caminhos privados, contas e tokens de qualquer registro compartilhado. A documentação oficial e a saída da versão instalada são a referência final quando um site ou uma opção muda. Em tarefas recorrentes, mantenha uma configuração revisada, um caminho estável e um arquivo de downloads com cópia de segurança.

A documentação oficial e a saída da versão instalada são a referência final quando um site ou uma opção muda. Em tarefas recorrentes, mantenha uma configuração revisada, um caminho estável e um arquivo de downloads com cópia de segurança. Se ocorrer um erro, repita um teste limpo com --config-ignore e --simulate antes de alterar várias opções.

Mostrar o estado da configuração
gallery-dl --config-status
Abrir a configuração
gallery-dl --config-open
Ignorar a configuração em um teste
gallery-dl --config-ignore --simulate "URL"
como usar gallery-dl · guia prático · Preparação

como usar gallery-dl: Limites e diagnóstico

A documentação oficial e a saída da versão instalada são a referência final quando um site ou uma opção muda. Em tarefas recorrentes, mantenha uma configuração revisada, um caminho estável e um arquivo de downloads com cópia de segurança. Se ocorrer um erro, repita um teste limpo com --config-ignore e --simulate antes de alterar várias opções.

Em tarefas recorrentes, mantenha uma configuração revisada, um caminho estável e um arquivo de downloads com cópia de segurança. Se ocorrer um erro, repita um teste limpo com --config-ignore e --simulate antes de alterar várias opções. como usar gallery-dl ajuda a preparar, verificar e executar tarefas locais de download com controle sem enviar a URL nem credenciais para este site.

Perguntas frequentes

como usar gallery-dl: Perguntas frequentes

Como uso gallery-dl no primeiro download?

Execute gallery-dl --simulate com uma URL compatível entre aspas. Se o extractor for reconhecido, baixe primeiro um intervalo pequeno e confira os caminhos.

como usar gallery-dl · guia prático · Preparação: Preparação?

Na seção Preparação, comece com uma URL pública pequena e use a simulação antes de gravar arquivos. Confirme a versão instalada, o extrator reconhecido, a pasta de destino e cada opção adicionada antes de continuar.

como usar gallery-dl · guia prático · Preparação: Verificação?

Confirme a versão instalada, o extrator reconhecido, a pasta de destino e cada opção adicionada antes de continuar. Adicione cookies, filtros, intervalos ou arquivos de histórico separadamente para entender o efeito de cada alteração.

como usar gallery-dl · guia prático · Preparação: Privacidade?

Adicione cookies, filtros, intervalos ou arquivos de histórico separadamente para entender o efeito de cada alteração. Mantenha os dados de autenticação no seu dispositivo e remova caminhos privados, contas e tokens de qualquer registro compartilhado.

como usar gallery-dl · guia prático · Preparação: Casos comuns?

Mantenha os dados de autenticação no seu dispositivo e remova caminhos privados, contas e tokens de qualquer registro compartilhado. A documentação oficial e a saída da versão instalada são a referência final quando um site ou uma opção muda.

como usar gallery-dl · guia prático · Preparação: Limites e diagnóstico?

A documentação oficial e a saída da versão instalada são a referência final quando um site ou uma opção muda. Em tarefas recorrentes, mantenha uma configuração revisada, um caminho estável e um arquivo de downloads com cópia de segurança.

como usar gallery-dl · guia prático · Preparação: Conceitos básicos?

Em tarefas recorrentes, mantenha uma configuração revisada, um caminho estável e um arquivo de downloads com cópia de segurança. Se ocorrer um erro, repita um teste limpo com --config-ignore e --simulate antes de alterar várias opções.

Referências oficiais

Referências oficiais 1Referências oficiais 2
PRÓXIMO PASSO

Recursos relacionados