gallery-dl

gallery-dl is a small command-line tool to download images and entire image galleries from several image hosting platforms.

Installation

You can install gallery-dl with pip:

$ pip install gallery-dl

or directly from github:

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

Usage

$ gallery-dl URL [URL...]

Supported Sites

• Booru:

  behoimi.org, danbooru.donmai.us, e621.net, gelbooru.com, konachan.com, safebooru.org, chan.sankakucomplex.com, yande.re

• Manga:

  bato.to, kissmanga.com, mangahere.co, mangamint.com, mangapanda.com, mangapark.me, mangareader.net, mangashare.com, mangastream.com, powermanga.org, raw.senmanga.com, thespectrum.net

• Hentai:

  exhentai.org, hbrowse.com, hentai2read.com, hentai-foundry.com, hitomi.la, luscious.net, nhentai.net

• Japanese:

  pixiv.net, nijie.info

• Western:

  deviantart.com, imgth.com, imgur.com, tumblr.com

• Futaba Channel-like:

  4chan.org, 8ch.net

• Image Hosts:

  chronos.to, imagebam.com, imagetwist.com, imgbox.com, imgchili.net, img.yt, turboimagehost.com

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:

• /etc/gallery-dl.conf
• ~/.config/gallery-dl/config.json
• ~/.gallery-dl.conf

Values in later configuration files will override previous ones.

Authentication

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

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