gallery-dl 0.8.0

Command-line program to download image galleries and collections from pixiv, exhentai, danbooru, gelbooru, nijie and more

gallery-dl is a command-line program to download image-galleries and -collections from several image hosting sites such as pixiv.net, exhentai.org, gelbooru.com and several more (see Supported Sites). It requires Python 3.3+ to run and works on Unix-like systems as well as Windows.

1 Installation

You can install the latest stable version of gallery-dl from PyPI with pip:

$ pip install --upgrade gallery-dl

or directly from GitHub:

$ git clone https://github.com/mikf/gallery-dl.git
$ cd gallery-dl
$ python3 setup.py install

Windows users can also download a standalone executable.

2 Usage

To use gallery-dl simply call it with the URLs you wish to download images from:

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

See also gallery-dl --help.

2.1 Examples

Download images from gelbooru found via tag search for ‘bonocho’:

$ gallery-dl "http://gelbooru.com/index.php?page=post&s=list&tags=bonocho"

Get the direct URL of an image from a site that requires authentication:

$ gallery-dl -g -u <username> -p <password> http://seiga.nicovideo.jp/seiga/im3211703

Search a remote resource for URLs and download images from them:

(URLs for which no extractor can be found will be silently ignored)

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

3 Supported Sites

• pixiv.net

• seiga.nicovideo.jp

• nijie.info

• bato.to

• mangastream.com

• readcomiconline.to

• danbooru.donmai.us

• gelbooru.com

• exhentai.org

• nhentai.net

• luscious.net

• hentaifoundry.com

• deviantart.com

• tumblr.com

• Complete List

4 Configuration

Configuration files for gallery-dl use a JSON-based file format. For a (more or less) complete example, see gallery-dl.conf.

gallery-dl searches for configuration files in the following paths:

Linux	Windows
/etc/gallery-dl.conf ${HOME}/.config/gallery-dl/config.json ${HOME}/.gallery-dl.conf	%USERPROFILE%\gallery-dl\config.json %USERPROFILE%\gallery-dl.conf

(%USERPROFILE% usually refers to the users home directory, i.e. C:\Users\<username>\)

Values in later configuration files will override previous ones.

5 Authentication

Some extractors require you to provide valid login-credentials. This currently includes pixiv, exhentai, nijie, seiga and batoto.

You can set the necessary information in your configuration file (cf. gallery-dl.conf)

{
    "extractor": {
        ...
        "pixiv": {
            "username": "<username>",
            "password": "<password>"
        }
        ...
    }
}

or you can provide them directly via the -u/--username and -p/--password or via the -o/--option command-line options

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