Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Another API-less Instagram pictures and videos downloader

Project description

InstaLooter |starme|
====================

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

|build| |repo| |versions| |format| |coverage| |doc| |requirements| |grade| |license|

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

*The version* ``v1.0.0`` *was completely rewrote from scratch, and as such, will
probably break compatibility with your homemade. Meanwhile, great care was
taken to keep the CLI as consistent as possible with the previous versions.*

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

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

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

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

.. |grade| image:: https://img.shields.io/codacy/grade/9b8c7da6887c4195b9e960cb04b59a91/master.svg?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?style=flat-square
:target: https://codecov.io/gh/althonos/InstaLooter

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

.. |doc| image:: https://img.shields.io/readthedocs/instalooter.svg?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
:target: https://requires.io/github/althonos/InstaLooter/requirements/?branch=master

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

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


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

+-------------------+----------------------------+----------------------+------------------------+-------------------------+
| **coloredlogs** | Colored output | |PyPI coloredlogs| | |Source coloredlogs| | |License coloredlogs| |
+-------------------+----------------------------+----------------------+------------------------+-------------------------+
| **dateutil** | Date manipulation | |PyPI dateutil| | |Source dateutil| | |License dateutil| |
+-------------------+----------------------------+----------------------+------------------------+-------------------------+
| **docopt** | CLI arguments parsing | |PyPI docopt| | |Source docopt| | |License docopt| |
+-------------------+----------------------------+----------------------+------------------------+-------------------------+
| **fs** | Filesystem handling | |PyPI fs| | |Source fs| | |License fs| |
+-------------------+----------------------------+----------------------+------------------------+-------------------------+
| **requests** | HTTP handling | |PyPI requests| | |Source requests| | |License requests| |
+-------------------+----------------------------+----------------------+------------------------+-------------------------+
| **six** | Python 2/3 compatibility | |PyPI six| | |Source six| | |License six| |
+-------------------+----------------------------+----------------------+------------------------+-------------------------+
| **tenacity** | Retry until success | |PyPI tenacity| | |Source tenacity| | |License tenacity| |
+-------------------+----------------------------+----------------------+------------------------+-------------------------+
| **tqdm** | Dynamic output in CLI | |PyPI tqdm| | |Source tqdm| | |License tqdm| |
+-------------------+----------------------------+----------------------+------------------------+-------------------------+


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

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

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

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

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

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

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

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

.. |Source coloredlogs| image:: https://img.shields.io/badge/source-GitHub-303030.svg?style=flat-square
:target: https://github.com/xolox/python-coloredlogs

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

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

.. |Source fs| image:: https://img.shields.io/badge/source-GitHub-303030.svg?style=flat-square
:target: https://github.com/PyFilesystem/pyfilesystem2

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

.. |Source six| image:: https://img.shields.io/badge/source-GitHub-303030.svg?style=flat-square
:target: https://github.com/benjaminp/six

.. |Source six| image:: https://img.shields.io/badge/source-GitHub-303030.svg?style=flat-square
:target: https://github.com/jd/tenacity

.. |Source tqdm| image:: https://img.shields.io/badge/source-GitHub-303030.svg?style=flat-square
:target: https://github.com/tqdm/tqdm

.. For some reason shields.io does not retrieve the MIT license from PyPI
.. |License coloredlogs| image:: https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square
:target: https://choosealicense.com/licenses/mit/

.. |License dateutil| image:: https://img.shields.io/pypi/l/python-dateutil.svg?style=flat-square
:target: https://choosealicense.com/licenses/apache-2.0/

.. |License docopt| image:: https://img.shields.io/pypi/l/docopt.svg?style=flat-square
:target: https://choosealicense.com/licenses/mit/

.. |License fs| image:: https://img.shields.io/pypi/l/fs.svg?style=flat-square
:target: https://choosealicense.com/licenses/mit/

.. |License requests| image:: https://img.shields.io/pypi/l/requests.svg?style=flat-square
:target: https://choosealicense.com/licenses/apache-2.0/

.. |License six| image:: https://img.shields.io/pypi/l/six.svg?style=flat-square
:target: https://choosealicense.com/licenses/mit/

.. |License six| image:: https://img.shields.io/pypi/l/tenacity.svg?style=flat-square
:target: https://choosealicense.com/licenses/apache-2.0/

.. |License tqdm| image:: https://img.shields.io/pypi/l/tqdm.svg?style=flat-square
:target: https://choosealicense.com/licenses/mpl-2.0/


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 `documentation <http://instalooter.readthedocs.io/en/latest/index.html>`_.
Yet, you will probably end up using the following command::

pip install --user instalooter


Usage
-----

instalooter comes with its CLI::

$ instalooter user <username> [<directory>] [options]
$ instalooter hashtag <hashtag> <directory> [options]
$ instalooter post <post_token> <directory> [options]
$ instalooter batch <batch_file>

See ``instalooter --usage`` for all possible uses, or ``instalooter --help``
for a complete usage guide.


Logging in and out
------------------
There are two ways to login on Instagram through instalooter:

* use the *login* subcommand (``instalooter login``) to interactively login
using your username and password.
* give a ``--username`` (and, if you want, a ``--password``) argument to any of
the download commands.

In both cases, a session cookie will be created in the system temporary folder.
To delete it and close your session on the server, use the ``logout``
subcommand.


Examples
--------

Download all pictures from the *instagram* profile in the current directory::

$ instalooter user 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/" .

Use a configuration file to download from several account using custom parameters
(see `Batch mode <http://instalooter.readthedocs.io/en/latest/batch.html>`_)::

$ instalooter batch /path/to/a/config/file.ini

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


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for instalooter, version 1.0.0a1
Filename, size File type Python version Upload date Hashes
Filename, size instalooter-1.0.0a1-py2.py3-none-any.whl (44.5 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size instalooter-1.0.0a1.tar.gz (37.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page