Installation

InstaLooter is available from 2 different sources: either a git repository, shared publicly on GitHub, and a Python wheel, available on PyPI. Instructions on how to setup each version are available below.

The python modules pip and setuptools are required before you start installing InstaLooter. Although not strictly required, there will be no explanations on how to setup instaLooter without those.

Hint

See the PyPA web page page to install pip if it is not already installed.

Attention

Using pip will install InstaLooter with the default Python version. InstaLooter is known to work with Python versions 2.7, 3.4 and 3.5, but encoding errors have been reported with Python 2.7. If you are not familiar with the default Python version on you system, consider enforcing an installation with Python 3 using pip3 instead of pip.

PyPI pypi

If you have super user rights, open up a terminal and type the following:

# pip install instaLooter

If you don’t have admin rights, then type the following to install only for the current user instead:

$ pip install instaLooter --user

GitHub build

With git installed, do the following in a directory on your machine to clone the remote repository and install instaLooter from source:

$ git clone https://github.com/althonos/InstaLooter
$ cd InstaLooter

Then use pip to install the requirements (requires admin rights, or use with --user flag like shown before):

# pip install -r requirements.txt

Or, if you also want the feature of adding Exif metadata to the downloaded files, type:

# pip install -r requirements-metadata.txt

Once the dependencies are installed, either use the module in-place:

$ python -m instaLooter ...

Or install it to have access to the instaLooter command everywhere:

# pip install .