|pypi| |build| |gitter|

..内容：：

依赖

• Python_ 3.4+
• Requests_

自选

• FFmpeg_：将Pixiv Ugoira转换为WebM
• yt-dlp_ 或者 youtube-dl_： 视频下载
• PySocks_：袜子代理支持
• brotli_或brotlicffi_：布罗特利压缩支撑

安装

果仁

gallery-dl 的稳定版本分布在 PyPI_ 上，可以使用pip_轻松安装或升级：

..代码：： bash

python3 -m pip install -U gallery-dl

直接从 GitHub 安装最新的开发版本也可以使用 pip_完成：

..代码：： bash

python3 -m pip install -U -I --no-deps --no-cache-dir https://github.com/mikf/gallery-dl/archive/master.tar.gz

注意：Windows 用户应使用 ：code： 而不是 ：code：。

py -3

python3

建议使用最新版本的pip_，包括基本包 ：code： 和 ：code：。若要确保这些包是最新的，请运行

setuptools

wheel

..代码：： bash

python3 -m pip install --upgrade pip setuptools wheel

独立可执行文件

带有Python解释器的预构建可执行文件和随附的必需Python包可用于

• Windows <https://github.com/mikf/gallery-dl/releases/download/v1.22.4/gallery-dl.exe>

  __

• Linux   <https://github.com/mikf/gallery-dl/releases/download/v1.22.4/gallery-dl.bin>

  __

|从最新提交构建的可执行文件可以在|https://github.com/mikf/gallery-dl/actions/workflows/executables.yml

折

使用Snapd_支持的发行版的 Linux 用户可以从 Snap Store 安装 gallery-dl：

..代码：： bash

snap install gallery-dl

巧克力味

安装了Chocolatey_的 Windows 用户可以从 Chocolatey Community Packages 存储库安装 gallery-dl：

..代码：： 电源外壳

choco install gallery-dl

舀

gallery-dl 也可用于 Windows 用户的 Scoop_ “main” 存储桶：

..代码：： 电源外壳

scoop install gallery-dl

用法

要使用 gallery-dl，只需使用你希望从中下载图像的 URL 调用它：

..代码：： bash

gallery-dl [OPTION]... URL...

另请参见 ：代码：。

gallery-dl --help

例子

下载图片;在这种情况下，从danbooru通过标签搜索“bonocho”：

..代码：： bash

gallery-dl "https://danbooru.donmai.us/posts?tags=bonocho"

从支持使用用户名和密码进行身份验证的站点获取图像的直接URL：

..代码：： bash

gallery-dl -g -u "<username>" -p "<password>" "https://twitter.com/i/web/status/604341487988576256"

按语言和章节编号筛选漫画章节：

..代码：： bash

gallery-dl --chapter-filter "lang == 'fr' and 10 <= chapter < 20" "https://mangadex.org/title/2354/"

|在远程资源中搜索 URL 并从中下载图像：|（找不到提取器的 URL 将被静默忽略）

..代码：： bash

gallery-dl "r:https://pastebin.com/raw/FLwrCYsT"

如果站点的地址对于其提取程序来说是非标准的，则可以在 URL 前面加上提取程序的名称，以强制使用特定的提取程序：

..代码：： bash

gallery-dl "tumblr:https://sometumblrblog.example"

配置

gallery-dl 的配置文件使用基于 JSON 的文件格式。

|有关选项设置为默认值的（或多或少）完整示例，请参阅库dl.conf_。|有关包含更多涉及的设置和选项的配置文件示例，请参阅 gallery-dl-example.conf_。|所有可用配置选项及其说明的列表可在configuration.rst_中找到。|

gallery-dl 在以下位置搜索配置文件：

视窗： *

%APPDATA%\gallery-dl\config.json

%USERPROFILE%\gallery-dl\config.json

%USERPROFILE%\gallery-dl.conf

(``%USERPROFILE%`` usually refers to the user's home directory,
i.e. ``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

你可以在配置文件中设置必要的信息（参见图库dl.conf_）

..代码：： json

{
    "extractor": {
        "twitter": {
            "username": "<username>",
            "password": "<password>"
        }
    }
}

或者你可以直接通过 ：code： 和 ：code： 或通过 ：code： 命令行选项提供它们

-u/--username

-p/--password

-o/--option

..代码：： bash

gallery-dl -u <username> -p <password> URL
gallery-dl -o username=<username> -o password=<password> URL

饼干

对于由于CAPTCHA或类似原因无法使用用户名和密码登录的网站，或者尚未实现的网站，你可以使用浏览器登录会话中的cookie并将其输入到gallery-dl中。

这可以通过配置文件中的 __ 选项完成，方法是指定

cookies <https://github.com/mikf/gallery-dl/blob/master/docs/configuration.rst#extractorcookies>

• |Mozilla/Netscape 格式 cookie 的路径.txt浏览器插件导出的文件|（例如 __代表 Chrome，__ 代表 Firefox）

  Get cookies.txt <https://chrome.google.com/webstore/detail/get-cookiestxt/bgaddhkoddajcdgocldbbfleckgcbcid/>

  Export Cookies <https://addons.mozilla.org/en-US/firefox/addon/export-cookies-txt/>

• |从浏览器的 Web 开发人员工具收集的名称/值对列表|（在 Firefox <https://developer.mozilla.org/en-US/docs/Tools/Storage_Inspector> 中

  Chrome <https://developers.google.com/web/tools/chrome-devtools/storage/cookies>

  )

{
    "extractor": {
        "instagram": {
            "cookies": "$HOME/path/to/cookies.txt"
        },
        "patreon": {
            "cookies": {
                "session_id": "K1T57EKu19TR49C51CDjOJoXNQLF7VbdVOiBrC9ye0a"
            }
        }
    }
}

--cookies

gallery-dl --cookies "$HOME/path/to/cookies.txt" URL

deviantart

flickr

reddit

smugmug

tumblr

mastodon

oauth:<sitename>

gallery-dl oauth:flickr

mastodon

oauth:mastodon:<instance>

gallery-dl oauth:mastodon:pawoo.net
gallery-dl oauth:mastodon:https://mastodon.social/