Skip to main content

gallery- and image downloader

Project description

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

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

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gallery_dl-0.6.1.tar.gz (59.5 kB view hashes)

Uploaded Source

Built Distribution

gallery_dl-0.6.1-py3-none-any.whl (123.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page