Metadata-Version: 1.2
Name: gallery_dl
Version: 0.8.2
Summary: Command-line program to download image galleries and collections from pixiv, exhentai, danbooru, gelbooru, nijie and more
Home-page: https://github.com/mikf/gallery-dl
Author: Mike Fährmann
Author-email: mike_faehrmann@web.de
License: GPLv2
Download-URL: https://github.com/mikf/gallery-dl/releases/latest
Description: ==========
        gallery-dl
        ==========
        
        **gallery-dl** is a command-line program to download image-galleries and
        -collections from several image hosting sites such as pixiv.net, exhentai.org,
        gelbooru.com and several more (see `Supported Sites`_). It requires Python 3.3+
        to run and works on Unix-like systems as well as Windows.
        
        
        |pypi| |build|
        
        .. section-numbering::
        
        
        Installation
        ============
        
        You can install the latest stable version of **gallery-dl** from PyPI_
        with pip_:
        
        .. code:: bash
        
            $ pip install --upgrade gallery-dl
        
        or directly from GitHub:
        
        .. code:: bash
        
            $ git clone https://github.com/mikf/gallery-dl.git
            $ cd gallery-dl
            $ python3 setup.py install
        
        Windows users can also download a `standalone executable`_.
        
        
        Usage
        =====
        
        To use **gallery-dl** simply call it with the URLs you wish to download images
        from:
        
        .. code:: bash
        
            $ gallery-dl [OPTION]... URL...
        
        See also :code:`gallery-dl --help`.
        
        
        Examples
        --------
        
        Download images from gelbooru found via tag search for 'bonocho':
        
        .. code:: bash
        
            $ gallery-dl "http://gelbooru.com/index.php?page=post&s=list&tags=bonocho"
        
        
        Get the direct URL of an image from a site that requires authentication:
        
        .. code:: bash
        
            $ gallery-dl -g -u <username> -p <password> http://seiga.nicovideo.jp/seiga/im3211703
        
        
        | Search a remote resource for URLs and download images from them:
        | (URLs for which no extractor can be found will be silently ignored)
        
        .. code:: bash
        
            $ gallery-dl r:https://pastebin.com/raw/FLwrCYsT
        
        
        Supported Sites
        ===============
        
        * pixiv.net
        * seiga.nicovideo.jp
        * nijie.info
        * bato.to
        * mangastream.com
        * kissmanga.com
        * readcomiconline.to
        * danbooru.donmai.us
        * gelbooru.com
        * exhentai.org
        * nhentai.net
        * luscious.net
        * hentaifoundry.com
        * deviantart.com
        * tumblr.com
        * `Complete List`_
        
        
        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
        
        
        .. _gallery-dl.conf:       https://github.com/mikf/gallery-dl/blob/master/gallery-dl.conf
        .. _Complete List:         https://github.com/mikf/gallery-dl/blob/master/supportedsites.rst
        .. _standalone executable: https://github.com/mikf/gallery-dl/releases/download/v0.8.2/gallery-dl.exe
        .. _Python:   https://www.python.org/downloads/
        .. _Requests: https://pypi.python.org/pypi/requests/
        .. _PyPI:     https://pypi.python.org/pypi
        .. _pip:      https://pip.pypa.io/en/stable/
        
        
        .. |pypi| image:: https://img.shields.io/pypi/v/gallery-dl.svg
            :target: https://pypi.python.org/pypi/gallery-dl
        
        .. |build| image:: https://travis-ci.org/mikf/gallery-dl.svg?branch=master
            :target: https://travis-ci.org/mikf/gallery-dl
        
Keywords: image gallery downloader crawler scraper
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Internet
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Multimedia
Classifier: Topic :: Multimedia :: Graphics
Requires-Python: >=3.3
