mirror of
https://github.com/mikf/gallery-dl.git
synced 2024-11-23 03:02:50 +01:00
Mirror of https://github.com/mikf/gallery-dl
bin | ||
gallery_dl | ||
test | ||
.gitignore | ||
.travis.yml | ||
gallery-dl.conf | ||
LICENSE | ||
README.rst | ||
requirements.txt | ||
setup.py |
========== gallery-dl ========== *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_: .. code:: bash $ pip install gallery-dl or directly from GitHub: .. code:: bash $ 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: .. code:: bash $ gallery-dl https://imgur.com/a/cMUxc See also :code:`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, gomanga.co, mangahere.co, mangamint.com, mangapanda.com, mangapark.me, mangareader.net, mangashare.com, mangastream.com, powermanga.org, raw.senmanga.com, reader.sensescans.com, thespectrum.net, slide.world-three.org, yomanga.co, yonkouprod.com * Comic: kisscomic.us, readcomiconline.to, readcomics.tv * 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``|* ``%USERPROFILE%\gallery-dl\config.json``| |* ``${HOME}/.gallery-dl.conf`` |* ``%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_) .. code:: { "extractor": { ... "pixiv": { "username": "<username>", "password": "<password>" } ... } } or you can provide them directly via the :code:`-u/--username` and :code:`-p/--password` or via the :code:`-o/--option` command-line options .. code:: bash $ gallery-dl -u <username> -p <password> URL $ gallery-dl -o username=<username> -o password=<password> URL .. _image hosting platforms: #supported-sites .. _gallery-dl.conf: https://github.com/mikf/gallery-dl/blob/master/gallery-dl.conf .. _Python: https://www.python.org/downloads/ .. _Requests: https://pypi.python.org/pypi/requests/ .. _pip: https://pip.pypa.io/en/stable/