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.

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.

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.

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

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

• pixiv.net
• seiga.nicovideo.jp
• nijie.info
• bato.to
• mangastream.com
• kissmanga.com
• readcomiconline.to
• danbooru.donmai.us
• gelbooru.com
• exhentai.org
• nhentai.net
• luscious.net
• hentai-foundry.com
• deviantart.com
• tumblr.com
• Complete List

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:

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

Values in later configuration files will override previous ones.

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