gallery-dl 0.6.1

gallery- and image downloader

gallery-dl is a small command-line tool to download images and entire image galleries from several image hosting platforms. It requires Python 3.3+ to run and works on Unix-like systems as well as Windows.

Dependencies

• Python 3.3+

• Requests 2.4.2+

Installation

You can install gallery-dl from PyPI 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

To download collections of images, simply call gallery-dl with the URLs pointing to them:

$ gallery-dl https://imgur.com/a/cMUxc

See also gallery-dl --help.

Supported Sites

• Booru:

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

• Manga:

  bato.to, dynasty-scans.com, kissmanga.com, kobato.hologfx.com, mangahere.co, mangamint.com, mangapanda.com, mangapark.me, mangareader.net, mangashare.com, mangastream.com, powermanga.org, raw.senmanga.com, reader.sensescans.com, thespectrum.net

• Comic:

  readcomiconline.to

• Hentai:

  exhentai.org, hbrowse.com, hentai2read.com, hentaibox.net, hentaihere.com, hitomi.la, luscious.net, nhentai.net

• Japanese:

  pixiv.net, nijie.info, seiga.nicovideo.jp

• Western:

  deviantart.com, hentai-foundry.com, imagefap,com, imgth.com, imgur.com, pinterest.com, tumblr.com, twitter.com, whentai.com

• Futaba Channel-like:

  4chan.org, 8ch.net

• Image Hosts:

  chronos.to, coreimg.net, hosturimage.com, imagebam.com, imageontime.org, imagetwist.com, img.yt, imgbox.com, imgcandy.net, imgchili.net, imgclick.net, imgmaid.net, imgspice.com, imgtrex.com, imgupload.yt, img4ever.net, pic-maniac.com, pixhost.org, rapidimg.net, 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:

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.

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