gallery dl
1.27.7
gallery-dl est un programme en ligne de commande permettant de télécharger des galeries d'images et des collections à partir de plusieurs sites d'hébergement d'images (voir Sites pris en charge). Il s'agit d'un outil multiplateforme doté de nombreuses options de configuration et de puissantes capacités de dénomination de fichiers.
Contenu
Dépendances
Facultatif
Installation
Pépin
Exécutable autonome
Constructions nocturnes
Instantané
Chocolaté
Scoop
Homebrew
MacPorts
Docker
Usage
Exemples
Configuration
Documentation
Emplacements
Authentification
Nom d'utilisateur et mot de passe
Cookies
OAuth
Python3.4+
Demandes
yt-dlp ou youtube-dl : téléchargements de vidéos HLS/DASH, intégration ytdl
FFmpeg : conversion Pixiv Ugoira
mkvmerge : codes temporels précis des images Ugoira
PySocks : prise en charge du proxy SOCKS
brotli ou brotlicffi : support de compression Brotli
zstandard : prise en charge de la compression Zstandard
PyYAML : prise en charge des fichiers de configuration YAML
toml : prise en charge du fichier de configuration TOML pour Python<3.11
SecretStorage : mots de passe du trousseau de clés GNOME pour --cookies-from-browser
Les versions stables de gallery-dl sont distribuées sur PyPI et peuvent être facilement installées ou mises à niveau à l'aide de pip :
python3 -m pip install -U galerie-dl
L'installation de la dernière version de développement directement depuis GitHub peut également être effectuée avec pip :
python3 -m pip install -U -I --no-deps --no-cache-dir https://github.com/mikf/gallery-dl/archive/master.tar.gz
Remarque : les utilisateurs Windows doivent utiliser py -3 au lieu de python3 .
Il est conseillé d'utiliser la dernière version de pip, comprenant les packages essentiels setuptools et wheel . Pour vous assurer que ces packages sont à jour, exécutez
python3 -m pip install --upgrade pip setuptools wheel
Des fichiers exécutables prédéfinis avec un interpréteur Python et les packages Python requis inclus sont disponibles pour
Windows (nécessite le package redistribuable Microsoft Visual C++ (x86))
Linux
Les exécutables construits à partir du dernier commit peuvent être trouvés sur
https://github.com/gdl-org/builds/releases
Les utilisateurs Linux qui utilisent une distribution prise en charge par Snapd peuvent installer gallery-dl à partir du Snap Store :
installation instantanée de la galerie-dl
Les utilisateurs Windows sur lesquels Chocolatey est installé peuvent installer gallery-dl à partir du référentiel Chocolatey Community Packages :
choco installer la galerie-dl
gallery-dl est également disponible dans le compartiment Scoop « principal » pour les utilisateurs Windows :
scoop installer la galerie-dl
Pour les utilisateurs de macOS ou Linux utilisant Homebrew :
Brew installer la galerie-dl
Pour les utilisateurs macOS avec MacPorts :
port sudo installer la galerie-dl
Utilisation du Dockerfile dans le référentiel :
git clone https://github.com/mikf/gallery-dl.gitcd gallery-dl/ docker build -t gallery-dl:latest .
Extraire une image de Docker Hub :
docker pull mikf123/gallery-dl balise docker mikf123/gallery-dl galerie-dl
Extraire une image de GitHub Container Registry :
docker pull ghcr.io/mikf/gallery-dl balise docker ghcr.io/mikf/gallery-dl galerie-dl
Pour exécuter le conteneur, vous souhaiterez probablement attacher certains répertoires sur l'hôte afin que le fichier de configuration et les téléchargements puissent persister d'une exécution à l'autre.
Assurez-vous soit de télécharger l'exemple de référence du fichier de configuration dans le référentiel et de le placer à l'emplacement du volume monté, soit d'y toucher un fichier vide.
Si vous avez attribué une balise différente au conteneur ou si vous utilisez podman, assurez-vous de l'ajuster. Exécutez docker image ls pour vérifier le nom si vous n'êtes pas sûr.
Cela supprimera le conteneur après chaque utilisation afin que vous disposiez toujours d'un nouvel environnement pour son exécution. Si vous configurez un pipeline ci-cd pour construire automatiquement le conteneur, vous pouvez également ajouter un indicateur --pull=newer afin que lorsque vous l'exécutez, Docker vérifie s'il existe un conteneur plus récent et le télécharge avant de l'exécuter.
docker run --rm -v $HOME/Downloads/:/gallery-dl/ -v $HOME/.config/gallery-dl/gallery-dl.conf:/etc/gallery-dl.conf -it gallery-dl : dernier
Vous pouvez également ajouter un alias à votre shell pour "gallery-dl" ou créer un simple script bash et le déposer quelque part dans votre $PATH pour agir comme une cale pour cette commande.
Pour utiliser gallery-dl, appelez-le simplement avec les URL à partir desquelles vous souhaitez télécharger des images :
galerie-dl [OPTIONS]... URL...
Utilisez gallery-dl --help ou consultez docs/options.md pour une liste complète de toutes les options de ligne de commande.
Télécharger des images ; dans ce cas, depuis danbooru via la recherche de balises pour 'bonocho' :
galerie-dl "https://danbooru.donmai.us/posts?tags=bonocho"
Obtenez l'URL directe d'une image à partir d'un site prenant en charge l'authentification avec nom d'utilisateur et mot de passe :
gallery-dl -g -u "<nom d'utilisateur>" -p "<mot de passe>" "https://twitter.com/i/web/status/604341487988576256"
Filtrer les chapitres de manga par numéro de chapitre et langue :
gallery-dl --chapter-filter "10 <= chapitre < 20" -o "lang=fr" "https://mangadex.org/title/59793dd0-a2d8-41a2-9758-8197287a8539"
Recherchez des URL dans une ressource distante et téléchargez des images à partir de celles-ci :
(Les URL pour lesquelles aucun extracteur ne peut être trouvé seront ignorées en silence)
galerie-dl "r:https://pastebin.com/raw/FLwrCYsT"
Si l'adresse d'un site n'est pas standard pour son extracteur, vous pouvez préfixer l'URL avec le nom de l'extracteur pour forcer l'utilisation d'un extracteur spécifique :
galerie-dl "tumblr :https://sometumblrblog.example"
Les fichiers de configuration pour gallery-dl utilisent un format de fichier basé sur JSON.
Une liste de toutes les options de configuration disponibles et leurs descriptions sont disponibles sur https://gdl-org.github.io/docs/configuration.html.
Pour un fichier de configuration par défaut avec les options disponibles définies sur leurs valeurs par défaut, voir docs/gallery-dl.conf.
Pour un exemple commenté avec des paramètres et une utilisation des options plus complexes, voir docs/gallery-dl-example.conf.
gallery-dl recherche les fichiers de configuration aux endroits suivants :
Fenêtres :
( %USERPROFILE% fait généralement référence au répertoire personnel d'un utilisateur, c'est-à-dire 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
Lorsqu'il est exécuté en tant qu'exécutable, gallery-dl recherchera également un fichier gallery-dl.conf dans le même répertoire que ledit exécutable.
Il est possible d'utiliser plusieurs fichiers de configuration à la fois. Dans ce cas, toutes les valeurs des fichiers après le premier seront fusionnées dans les paramètres déjà chargés et remplaceront potentiellement les précédentes.
Certains extracteurs exigent que vous fournissiez des informations de connexion valides sous la forme d'une paire nom d'utilisateur et mot de passe. Ceci est nécessaire pour nijie et facultatif pour aryion , danbooru , e621 , exhentai , idolcomplex , imgbb , inkbunny , mangadex , mangoxo , pillowfort , sankaku , subscribestar , tapas , tsumino , twitter et zerochan .
Vous pouvez définir les informations nécessaires dans votre fichier de configuration
{ "extracteur": { "twitter": { "nom d'utilisateur": "<nom d'utilisateur>", "mot de passe": "<mot de passe>"
}
}
} ou vous pouvez les fournir directement via les options de ligne de commande -u/--username et -p/--password ou via les options de ligne de commande -o/--option
gallery-dl -u "<nom d'utilisateur>" -p "<mot de passe>" "URL"gallery-dl -o "nom d'utilisateur=<nom d'utilisateur>" -o "mot de passe=<mot de passe>" "URL"
Pour les sites sur lesquels la connexion avec nom d'utilisateur et mot de passe n'est pas possible en raison de CAPTCHA ou similaire, ou n'a pas encore été implémentée, vous pouvez utiliser les cookies à partir d'une session de connexion du navigateur et les saisir dans gallery-dl .
Cela peut être fait via l'option cookies dans votre fichier de configuration en précisant
le chemin d'accès à un fichier cookies.txt au format Mozilla/Netscape exporté par un module complémentaire de navigateur
(par exemple, obtenez cookies.txt LOCALEMENT pour Chrome, exportez les cookies pour Firefox)
une liste de paires nom-valeur collectées à partir des outils de développement Web de votre navigateur
(sous Chrome, sous Firefox)
le nom d'un navigateur à partir duquel extraire les cookies
(les navigateurs pris en charge sont ceux basés sur Chromium, Firefox et Safari)
Par exemple:
{ "extracteur": { "instagram": { "cookies": "$HOME/path/to/cookies.txt"
}, "patreon": { "cookies": { "session_id": "K1T57EKu19TR49C51CDjOJoXNQLF7VbdVOiBrC9ye0a"
}
}, "twitter": { "cookies": ["firefox"]
}
}
} Vous pouvez également spécifier un fichier cookies.txt avec l'option de ligne de commande --cookies
ou un navigateur pour extraire les cookies avec --cookies-from-browser :
gallery-dl --cookies "$HOME/path/to/cookies.txt" "URL"gallery-dl --cookies-from-browser firefox "URL"
gallery-dl prend en charge l'authentification des utilisateurs via OAuth pour certains extracteurs. Ceci est nécessaire pour pixiv et facultatif pour les instances deviantart , flickr , reddit , smugmug , tumblr et mastodon .
Lier votre compte à gallery-dl lui donne la possibilité d'émettre des demandes au nom de votre compte et lui permet d'accéder à des ressources qui autrement ne seraient pas disponibles pour un utilisateur public.
Pour ce faire, commencez par l’invoquer avec oauth:<sitename> comme argument. Par exemple:
galerie-dl oauth:flickr
Vous serez redirigé vers la page d'autorisation du site et invité à accorder l'accès en lecture à gallery-dl . Autorisez-le et un ou plusieurs "jetons" vous seront affichés, qui doivent être ajoutés à votre fichier de configuration.
Pour vous authentifier auprès d'une instance mastodon , exécutez gallery-dl avec oauth:mastodon:<instance> comme argument. Par exemple:
galerie-dl oauth:mastodon:pawoo.net galerie-dl oauth:mastodon:https://mastodon.social/
