gallery dl
1.27.7
gallery-dl é um programa de linha de comando para baixar galerias e coleções de imagens de vários sites de hospedagem de imagens (consulte Sites Suportados). É uma ferramenta multiplataforma com muitas opções de configuração e poderosos recursos de nomeação de arquivos.
Conteúdo
Dependências
Opcional
Instalação
Pip
Executável autônomo
Construções noturnas
Foto
Chocolate
Colher
Cerveja caseira
MacPorts
Docker
Uso
Exemplos
Configuração
Documentação
Locais
Autenticação
Nome de usuário e senha
Biscoitos
OAuth
Python 3.4+
Solicitações
yt-dlp ou youtube-dl: downloads de vídeo HLS/DASH, integração ytdl
FFmpeg: conversão Pixiv Ugoira
mkvmerge: códigos de tempo de quadro Ugoira precisos
PySocks: suporte a proxy SOCKS
brotli ou brotlicffi: suporte à compressão Brotli
zstandard: suporte à compressão Zstandard
PyYAML: suporte a arquivo de configuração YAML
toml: suporte ao arquivo de configuração TOML para Python<3.11
SecretStorage: senhas do chaveiro do GNOME para --cookies-from-browser
As versões estáveis do gallery-dl são distribuídas no PyPI e podem ser facilmente instaladas ou atualizadas usando pip:
python3 -m pip instalar -U galeria-dl
A instalação da versão de desenvolvimento mais recente diretamente do GitHub também pode ser feita com pip:
python3 -m pip install -U -I --no-deps --no-cache-dir https://github.com/mikf/gallery-dl/archive/master.tar.gz
Nota: Os usuários do Windows devem usar py -3 em vez de python3 .
É aconselhável usar a versão mais recente do pip, incluindo os pacotes essenciais setuptools e wheel . Para garantir que esses pacotes estejam atualizados, execute
python3 -m pip install --upgrade pip setuptools roda
Arquivos executáveis pré-construídos com um interpretador Python e pacotes Python necessários incluídos estão disponíveis para
Windows (requer pacote redistribuível Microsoft Visual C++ (x86))
Linux
Os executáveis compilados a partir do commit mais recente podem ser encontrados em
https://github.com/gdl-org/builds/releases
Os usuários do Linux que usam uma distribuição compatível com Snapd podem instalar o gallery-dl do Snap Store:
instalação instantânea galeria-dl
Os usuários do Windows que possuem o Chocolatey instalado podem instalar o gallery-dl do repositório de pacotes comunitários do Chocolatey:
choco instalar galeria-dl
gallery-dl também está disponível no bucket "principal" do Scoop para usuários do Windows:
colher instalar galeria-dl
Para usuários de macOS ou Linux que usam Homebrew:
preparar instalar galeria-dl
Para usuários do macOS com MacPorts:
porta sudo instalar galeria-dl
Usando o Dockerfile no repositório:
clone do git https://github.com/mikf/gallery-dl.gitcd gallery-dl/ docker build -t galeria-dl:mais recente.
Extraindo imagem do Docker Hub:
docker pull mikf123/gallery-dl tag docker mikf123/gallery-dl galeria-dl
Extraindo imagem do GitHub Container Registry:
docker pull ghcr.io/mikf/gallery-dl tag docker ghcr.io/mikf/gallery-dl gallery-dl
Para executar o contêiner, você provavelmente desejará anexar alguns diretórios no host para que o arquivo de configuração e os downloads possam persistir durante as execuções.
Certifique-se de baixar a referência do arquivo de configuração de exemplo no repositório e colocá-lo no local do volume montado ou tocar em um arquivo vazio lá.
Se você deu ao contêiner uma tag diferente ou está usando podman, certifique-se de ajustar. Execute docker image ls para verificar o nome se não tiver certeza.
Isso removerá o contêiner após cada uso, para que você sempre tenha um ambiente novo para ele funcionar. Se você configurar um pipeline ci-cd para construir automaticamente o contêiner, você também pode adicionar um sinalizador --pull=newer para que, ao executá-lo, o docker verifique se há um contêiner mais recente e faça o download dele antes de executar.
docker run --rm -v $HOME/Downloads/:/gallery-dl/ -v $HOME/.config/gallery-dl/gallery-dl.conf:/etc/gallery-dl.conf -it gallery-dl: mais recente
Você também pode adicionar um alias ao seu shell para "gallery-dl" ou criar um script bash simples e soltá-lo em algum lugar do seu $PATH para atuar como um shim para este comando.
Para usar o gallery-dl, basta chamá-lo com os URLs dos quais deseja baixar as imagens:
galeria-dl [OPÇÕES]... URLS...
Use gallery-dl --help ou consulte docs/options.md para obter uma lista completa de todas as opções de linha de comando.
Baixar imagens; neste caso, de danbooru por meio de pesquisa de tag por 'bonocho':
galeria-dl "https://danbooru.donmai.us/posts?tags=bonocho"
Obtenha o URL direto de uma imagem de um site que suporta autenticação com nome de usuário e senha:
gallery-dl -g -u "<nome de usuário>" -p "<senha>" "https://twitter.com/i/web/status/604341487988576256"
Filtre capítulos de mangá por número de capítulo e idioma:
gallery-dl --chapter-filter "10 <= capítulo <20" -o "lang=fr" "https://mangadex.org/title/59793dd0-a2d8-41a2-9758-8197287a8539"
Pesquise URLs em um recurso remoto e baixe imagens deles:
(URLs para os quais nenhum extrator pode ser encontrado serão ignorados silenciosamente)
galeria-dl "r: https://pastebin.com/raw/FLwrCYsT"
Se o endereço de um site não for padrão para seu extrator, você poderá prefixar o URL com o nome do extrator para forçar o uso de um extrator específico:
galeria-dl "tumblr: https://sometumblrblog.example"
Os arquivos de configuração do gallery-dl usam um formato de arquivo baseado em JSON.
Uma lista de todas as opções de configuração disponíveis e suas descrições pode ser encontrada em https://gdl-org.github.io/docs/configuration.html.
Para obter um arquivo de configuração padrão com opções disponíveis definidas com seus valores padrão, consulte docs/gallery-dl.conf.
Para um exemplo comentado com configurações mais complexas e uso de opções, consulte docs/gallery-dl-example.conf.
gallery-dl procura arquivos de configuração nos seguintes locais:
Windows:
( %USERPROFILE% geralmente se refere ao diretório inicial de um usuário, ou seja C:Users<username> )
%APPDATA%gallery-dlconfig.json
%USERPROFILE%gallery-dlconfig.json
%USERPROFILE%gallery-dl.conf
Linux, macOS, etc.:
/etc/gallery-dl.conf
${XDG_CONFIG_HOME}/gallery-dl/config.json
${HOME}/.config/gallery-dl/config.json
${HOME}/.gallery-dl.conf
Quando executado como executável, o gallery-dl também procurará um arquivo gallery-dl.conf no mesmo diretório do executável.
É possível usar mais de um arquivo de configuração por vez. Nesse caso, quaisquer valores dos arquivos após o primeiro serão mesclados nas configurações já carregadas e potencialmente substituirão os anteriores.
Alguns extratores exigem que você forneça credenciais de login válidas na forma de um par de nome de usuário e senha. Isso é necessário para nijie e opcional para aryion , danbooru , e621 , exhentai , idolcomplex , imgbb , inkbunny , mangadex , mangoxo , pillowfort , sankaku , subscribestar , tapas , tsumino , twitter e zerochan .
Você pode definir as informações necessárias em seu arquivo de configuração
{ "extrator": { "twitter": { "nome de usuário": "<nome de usuário>", "senha": "<senha>"
}
}
} ou você pode fornecê-los diretamente por meio de -u/--username e -p/--password ou por meio das opções de linha de comando -o/--option
gallery-dl -u "<nome de usuário>" -p "<senha>" "URL"gallery-dl -o "nome de usuário=<nome de usuário>" -o "senha=<senha>" "URL"
Para sites onde o login com nome de usuário e senha não é possível devido ao CAPTCHA ou similar, ou ainda não foi implementado, você pode usar os cookies de uma sessão de login do navegador e inseri-los em gallery-dl .
Isso pode ser feito através da opção cookies em seu arquivo de configuração, especificando
o caminho para um arquivo cookies.txt no formato Mozilla/Netscape exportado por um complemento do navegador
(por exemplo, obter cookies.txt LOCALMENTE para Chrome, exportar cookies para Firefox)
uma lista de pares nome-valor coletados das ferramentas de desenvolvedor web do seu navegador
(no Chrome, no Firefox)
o nome de um navegador do qual extrair cookies
(os navegadores suportados são baseados em Chromium, Firefox e Safari)
Por exemplo:
{ "extrator": { "instagram": { "cookies": "$HOME/path/to/cookies.txt"
}, "patreon": { "cookies": { "session_id": "K1T57EKu19TR49C51CDjOJoXNQLF7VbdVOiBrC9ye0a"
}
}, "twitter": { "cookies": ["firefox"]
}
}
} Você também pode especificar um arquivo cookies.txt com a opção de linha de comando --cookies
ou um navegador para extrair cookies com --cookies-from-browser :
gallery-dl --cookies "$HOME/caminho/para/cookies.txt" "URL"gallery-dl --cookies-from-browser firefox "URL"
gallery-dl suporta autenticação de usuário via OAuth para alguns extratores. Isso é necessário para pixiv e opcional para instâncias de deviantart , flickr , reddit , smugmug , tumblr e mastodon .
Vincular sua conta ao gallery-dl concede a ele a capacidade de emitir solicitações em nome de sua conta e permite acessar recursos que de outra forma não estariam disponíveis para um usuário público.
Para fazer isso, comece invocando-o com oauth:<sitename> como argumento. Por exemplo:
galeria-dl oauth: flickr
Você será direcionado para a página de autorização do site e solicitado a conceder acesso de leitura ao gallery-dl . Autorize-o e serão mostrados um ou mais "tokens", que deverão ser adicionados ao seu arquivo de configuração.
Para autenticar com uma instância mastodon , execute gallery-dl com oauth:mastodon:<instance> como argumento. Por exemplo:
galeria-dl oauth:mastodon:pawoo.net galeria-dl oauth:mastodon:https://mastodon.social/
