Metadata-Version: 2.0
Name: instaLooter
Version: 0.3.0
Summary: Another API-less Instagram pictures and videos downloader.
Home-page: http://github.com/althonos/InstaLooter
Author: althonos
Author-email: martin.larralde@ens-cachan.fr
License: GPLv3
Keywords: instagram,download,web,web scraping
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Operating System :: OS Independent
Requires-Dist: beautifulsoup4
Requires-Dist: docopt
Requires-Dist: progressbar2
Requires-Dist: requests
Requires-Dist: six
Provides-Extra: metadata
Requires-Dist: Pillow; extra == 'metadata'
Requires-Dist: beautifulsoup4; extra == 'metadata'
Requires-Dist: docopt; extra == 'metadata'
Requires-Dist: piexif; extra == 'metadata'
Requires-Dist: progressbar2; extra == 'metadata'
Requires-Dist: requests; extra == 'metadata'
Requires-Dist: six; extra == 'metadata'

InstaLooter |Starme|
====================

*Not all treasure's silver and gold, mate.*

InstaLooter is a program that can download any picture or video associated
from an Instagram profile, without any API access. It can be seen as a
re-implementation of the now deprecated `InstaRaider <https://github.com/akurtovic/InstaRaider>`_
developed by `@akurtovic <https://github.com/akurtovic>`_.


Requirements
------------

+-------------------+----------------------------+----------------------+------------------------+-------------------------+
| **BeautifulSoup** |  HTML parsing              | |PyPI BeautifulSoup| | |Source BeautifulSoup| | |License BeautifulSoup| |
+-------------------+----------------------------+----------------------+------------------------+-------------------------+
| **docopt**        |  CLI arguments parsing     | |PyPI docopt|        | |Source docopt|        | |License docopt|        |
+-------------------+----------------------------+----------------------+------------------------+-------------------------+
| **progressbar2**  |  Dynamic output in CLI     | |PyPI progressbar2|  | |Source progressbar2|  | |License progressbar2|  |
+-------------------+----------------------------+----------------------+------------------------+-------------------------+
| **requests**      |  HTTP handling             | |PyPI requests|      | |Source requests|      | |License requests|      |
+-------------------+----------------------------+----------------------+------------------------+-------------------------+
| **six**           |  Python 2/3 compatibility  | |PyPI six|           | |Source six|           | |License six|           |
+-------------------+----------------------------+----------------------+------------------------+-------------------------+

Usage
-----

InstaLooter comes with its CLI::

    $ instaLooter <username> <directory> [options]
    $ instaLooter tag <hashtag> <directory> [options]

Arguments
^^^^^^^^^
- ``username``
    the username of the instagram account to download pictures and videos from.
- ``hashtag``
    the hashtag to download pictures and videos from.
- ``directory``
    the directory to download files into.

Options
^^^^^^^
- ``-n NUM, --num-to-dl NUM``
    number of maximum new posts to download (if not specified all
    posts are downloaded).
- ``-m, --add-metadata``
    add date and caption metadata to downloaded pictures (requires
    piexif and PIL/Pillow)
- ``-v, --get-videos``
    also download videos.
- ``-j JOBS, --jobs JOBS``
    the number of parallel threads to use to download files. It is
    advised to use a value of at least 12 as Instagram profile pages
    display 12 medias at a time in order to insure parallel download
    of all files. [default: 16]
- ``-c CRED, --credentials CRED``
    the login and password to use to login to Instagram, if needed
    (for instance: downloading medias from a private account you
    follow). [format: login:password]
- ``-q, --quiet``
    do not produce any output.


Installation
------------

>From PyPI
^^^^^^^^^
.. code::

    $ pip install instaLooter  # requires super-user rights

>From GitHub
^^^^^^^^^^^
.. code::

    $ git clone https://github.com/althonos/InstaLooter
    $ cd InstaLooter
    $ pip install .            # requires super-user rights


.. |Starme| image:: https://img.shields.io/github/stars/althonos/InstaLooter.svg?style=social&label=Star
   :target: https://github.com/althonos/InstaLooter

.. |PyPI requests| image:: https://img.shields.io/pypi/v/requests.svg?maxAge=3600
   :target: https://pypi.python.org/pypi/requests

.. |PyPI BeautifulSoup| image:: https://img.shields.io/pypi/v/beautifulsoup4.svg?maxAge=3600
   :target: https://pypi.python.org/pypi/beautifulsoup4

.. |PyPI six| image:: https://img.shields.io/pypi/v/six.svg?maxAge=3600
   :target: https://pypi.python.org/pypi/six

.. |PyPI progressbar2| image:: https://img.shields.io/pypi/v/progressbar2.svg?maxAge=3600
   :target: https://pypi.python.org/pypi/progressbar2

.. |PyPI docopt| image:: https://img.shields.io/pypi/v/docopt.svg?maxAge=3600
   :target: https://pypi.python.org/pypi/docopt/

.. |Source requests| image:: https://img.shields.io/badge/source-GitHub-green.svg?maxAge=3600
   :target: https://github.com/kennethreitz/requests

.. |Source docopt| image:: https://img.shields.io/badge/source-GitHub-green.svg?maxAge=3600
   :target: https://github.com/docopt/docopt

.. |Source BeautifulSoup| image:: https://img.shields.io/badge/source-Launchpad-orange.svg?maxAge=3600
   :target: https://launchpad.net/beautifulsoup

.. |Source six| image:: https://img.shields.io/badge/source-Bitbucket-blue.svg?maxAge=3600
   :target: https://bitbucket.org/gutworth/six

.. |Source progressbar2| image:: https://img.shields.io/badge/source-GitHub-green.svg?maxAge=3600
   :target: https://github.com/WoLpH/python-progressbar

.. |License requests| image:: https://img.shields.io/pypi/l/requests.svg?maxAge=3600
   :target: https://opensource.org/licenses/Apache-2.0

.. |License BeautifulSoup| image:: https://img.shields.io/pypi/l/BeautifulSoup4.svg?maxAge=3600
   :target: https://opensource.org/licenses/MIT

.. |License six| image:: https://img.shields.io/pypi/l/BeautifulSoup4.svg?maxAge=3600
   :target: https://opensource.org/licenses/MIT

.. |License progressbar2| image:: https://img.shields.io/pypi/l/progressbar2.svg?maxAge=3600
   :target: https://opensource.org/licenses/BSD-3-Clause

.. |License docopt| image:: https://img.shields.io/pypi/l/docopt.svg?maxAge=3600
   :target: https://opensource.org/licenses/MIT



