1
0
mirror of https://github.com/mikf/gallery-dl.git synced 2024-11-22 10:42:34 +01:00
Go to file
2015-12-14 01:56:49 +01:00
bin update setup.py 2015-04-16 02:57:36 +02:00
gallery_dl [mangapark] fix regexes 2015-12-14 01:56:49 +01:00
test make test-parameters optional 2015-12-13 03:56:29 +01:00
.gitignore update .gitignore 2015-10-01 14:56:58 +02:00
gallery-dl.conf [nijie] proper login and other issues fixed 2015-12-11 00:07:21 +01:00
LICENSE initial commit 2014-10-12 21:56:44 +02:00
README.rst update README 2015-11-10 21:13:43 +01:00
setup.py update setup.py and bump version 2015-12-03 02:31:23 +01:00

==========
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