从多个图像托管站点下载图像库和集合的命令行程序
项目描述
gallery-dl是一个命令行程序，用于从多个图像托管站点（请参阅支持的站点）下载图像库和集合。它是一个跨平台工具，具有许多配置选项和强大的文件命名功能。
内容
</nav>依赖项
可选的
FFmpeg：Pixiv Ugoira 到 WebM 的转换
yt-dlp或youtube-dl：视频下载
PySocks：SOCKS 代理支持
brotli或brotlicffi : Brotli 压缩支持
安装
点
gallery-dl的稳定版本分布在PyPI上，可以使用pip轻松安装或升级：
python3 -m pip install -U gallery-dl也可以使用 pip直接从 GitHub 安装最新的开发版本：
python3 -m pip install -U -I --no-deps --no-cache-dir https://github.com/mikf/gallery-dl/archive/master.tar.gz注意：Windows 用户应使用py -3而不是python3.
建议使用最新版本的pip，包括基本包setuptools和wheel. 为了确保这些包是最新的，运行
python3 -m pip install --upgrade pip setuptools wheel独立可执行文件
包含 Python 解释器和所需 Python 包的预构建可执行文件可用于
折断
使用Snapd支持的发行版的 Linux 用户可以从 Snap Store安装gallery-dl ：
snap install gallery-dl巧克力味
安装了Chocolatey的Windows 用户可以从 Chocolatey 社区包存储库安装gallery-dl ：
choco install gallery-dl舀
Gallery-dl也可以在Scoop “主”存储桶中供 Windows 用户使用：
scoop install gallery-dl用法
要使用gallery-dl，只需使用您希望从以下位置下载图像的 URL 调用它：
gallery-dl [OPTION]... URL...另请参阅gallery-dl --help。
例子
下载图片；在这种情况下，来自 danbooru 通过标签搜索“bonocho”：
gallery-dl "https://danbooru.donmai.us/posts?tags=bonocho"从支持使用用户名和密码进行身份验证的站点获取图像的直接 URL：
gallery-dl -g -u "<username>" -p "<password>" "https://twitter.com/i/web/status/604341487988576256"按章节编号和语言过滤漫画章节：
gallery-dl --chapter-filter "10 <= chapter < 20" -o "lang=fr" "https://mangadex.org/title/59793dd0-a2d8-41a2-9758-8197287a8539"gallery-dl "r:https://pastebin.com/raw/FLwrCYsT"如果一个站点的地址对于它的提取器来说是非标准的，您可以在 URL 前面加上提取器的名称来强制使用特定的提取器：
gallery-dl "tumblr:https://sometumblrblog.example"配置
gallery-dl的配置文件使用基于 JSON 的文件格式。
gallery-dl在以下位置搜索配置文件：
- 视窗：
%APPDATA%\gallery-dl\config.json
%USERPROFILE%\gallery-dl\config.json
%USERPROFILE%\gallery-dl.conf
（%USERPROFILE%通常指用户的主目录，即C:\Users\<username>\）
- Linux、macOS 等：
/etc/gallery-dl.conf
${XDG_CONFIG_HOME}/gallery-dl/config.json
${HOME}/.config/gallery-dl/config.json
${HOME}/.gallery-dl.conf
后面的配置文件中的值将覆盖以前的值。
命令行选项将覆盖配置文件中的所有相关设置，例如使用--write-metadata将启用使用所有postprocessors.metadata.*设置的默认值写入元数据，覆盖配置文件中的任何特定设置。
验证
用户名密码
一些提取器要求您以用户名和密码对的形式提供有效的登录凭据。这对于 nijie 是必需的， 对于 aryion、 danbooru、 e621、 exhentai、 idolcomplex、 imgbb、 inkbunny、 instagram、 mangadex、 mangoxo、 pillowfort、 sankaku、 subscribestar、 tapas、 tsumino、 twitter和zerochan是可选的。
您可以在配置文件中设置必要的信息（参见gallery-dl.conf）
{
"extractor": {
"twitter": {
"username": "<username>",
"password": "<password>"
}
}
}或者您可以通过
-u/--usernameand-p/--password或通过
-o/--option命令行选项直接提供它们
gallery-dl -u <username> -p <password> URL
gallery-dl -o username=<username> -o password=<password> URL身份验证
gallery-dl支持通过OAuth对 deviantart、flickr、reddit、smugmug、tumblr和mastodon实例进行用户身份验证。这主要是可选的，但授予gallery-dl代表您的帐户发出请求的能力，并使其能够访问公共用户无法使用的资源。
要将您的帐户链接到gallery-dl，首先使用 oauth:<sitename>作为参数调用它。例如：
gallery-dl oauth:flickr您将被发送到该站点的授权页面，并要求您授予对gallery-dl 的读取权限。授权它，您将看到一个或多个“令牌”，应将其添加到您的配置文件中。
要使用乳齿象实例进行身份验证，请使用 oauth:mastodon:<instance>作为参数运行gallery-dl 。例如：
gallery-dl oauth:mastodon:pawoo.net
gallery-dl oauth:mastodon:https://mastodon.social/
