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>_.

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

.. |repo| image:: https://img.shields.io/badge/source-GitHub-blue.svg?maxAge=3600&style=flat-square
:target: https://github.com/althonos/InstaLooter

.. |versions| image:: https://img.shields.io/pypi/v/instaLooter.svg?maxAge=3600&style=flat-square
:target: https://pypi.python.org/pypi/instaLooter

.. |format| image:: https://img.shields.io/pypi/format/instaLooter.svg?maxAge=3600&style=flat-square
:target: https://pypi.python.org/pypi/instaLooter

.. |grade| image:: https://img.shields.io/codacy/grade/9b8c7da6887c4195b9e960cb04b59a91/master.svg?maxAge=3600&style=flat-square
:target: https://www.codacy.com/app/althonos/InstaLooter/dashboard

.. |coverage| image:: https://img.shields.io/codecov/c/github/althonos/InstaLooter/master.svg?maxAge=3600&style=flat-square
:target: https://codecov.io/gh/althonos/InstaLooter

.. |build| image:: https://img.shields.io/travis/althonos/InstaLooter/master.svg?label=travis-ci&maxAge=3600&style=flat-square
:target: https://travis-ci.org/althonos/InstaLooter/

.. |doc| image:: https://readthedocs.org/projects/instalooter/badge/?version=latest&maxAge=3600&style=flat-square
:target: http://instalooter.readthedocs.io/en/latest/?badge=latest

.. |requirements| image:: https://img.shields.io/requires/github/althonos/InstaLooter/master.svg?style=flat-square&maxAge=3600
:target: https://requires.io/github/althonos/InstaLooter/requirements/?branch=master

.. |health| image:: https://landscape.io/github/althonos/InstaLooter/master/landscape.svg?style=flat-square&maxAge=3600
:target: https://landscape.io/github/althonos/InstaLooter/master

.. |license| image:: https://img.shields.io/pypi/l/InstaLooter.svg?maxAge=3600&style=flat-square
:target: https://choosealicense.com/licenses/gpl-3.0/

Requirements

Installation

InstaLooter is available on PyPI to install with pip. If you are not
familiar with the package management of the Python ecosystem, please see the
Installation page <http://instalooter.readthedocs.io/en/latest/install.html>_
of the online documentation <http://instalooter.readthedocs.io/en/latest/index.html>_.

Usage

InstaLooter comes with its CLI:

.. code-block:: console

$ instaLooter <username> [<directory>] [options]
$ instaLooter hashtag <hashtag> <directory> [options]
$ instaLooter post <post_token> <directory> [options]

Examples

.. code-block:: console

Download all pictures from the *instagram* profile in the current directory
$ instaLooter instagram

Download the latest 20 pictures or videos tagged with *python* to */tmp*
$ instaLooter hashtag python /tmp -n 20 -v -c MYLOGIN

Download a single post from an url in the current directory
$ instaLooter post "https://www.instagram.com/p/BFB6znLg5s1/" .

See more at the Usage page <http://instalooter.readthedocs.io/en/latest/usage.html>_
of the online documentation <http://instalooter.readthedocs.io/en/latest/index.html>_.

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

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

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

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

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

.. |PyPI dateutil| image:: https://img.shields.io/pypi/v/python-dateutil.svg?maxAge=3600&style=flat-square
:target: https://pypi.python.org/pypi/python-dateutil/

.. |PyPI hues| image:: https://img.shields.io/pypi/v/hues.svg?maxAge=3600&style=flat-square
:target: https://pypi.python.org/pypi/hues/

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

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

.. |Source dateutil| image:: https://img.shields.io/badge/source-GitHub-green.svg?maxAge=3600&style=flat-square
:target: https://github.com/dateutil/dateutil/

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

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