========== 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: .. 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 Supported Sites =============== * images (and ugoira) per artist from pixiv, nijie, deviantart * images per tag from booru-like sites (danbooru, gelbooru, chan.sankakucomplex, yandere, konachan, safebooru, 3dbooru, e621) * manga chapters from batoto, kissmanga, mangapanda, mangareader, mangastream, powermanga, redhawkscans * galleries from exhentai, nhentai, hitomi * images and videos from threads on Futaba Channel-like boards (4chan, 8chan) Usage ===== .. code:: bash $ gallery-dl URL [URL...] Certain supported sites require authentication to download images from. This currently includes pixiv, exhentai, gelbooru and nijie. To make these sites accessible to *gallery-dl* you need to specify the necessary login credentials or cookies in the configuration files. 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/config.json * ~/.config/gallery-dl.conf * ~/.gallery-dl.conf Values in later configuration files will override previous ones. .. _gallery-dl.conf: https://github.com/mikf/gallery-dl/blob/master/gallery-dl.conf