Skip to main content

InstaLooter starme

Not all treasure’s silver and gold, mate.

build repo versions format coverage doc grade license keepachangelog saythanks

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 developed by @akurtovic.

v1.0.0 was completely rewrote from scratch, and as such, will probably break compatibility with your homemade scripts. Meanwhile, great care was taken to keep the CLI as consistent as possible with the previous versions, so it’ll hopefully feel like home.

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

verboselogs

More detailed logs

PyPI verboselogs

Source verboselogs

License verboselogs

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 of the documentation. Yet, you will probably end up using the following command:

pip install --user instalooter --pre

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 a cache-specific 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 --get-videos -c MYLOGIN

Download a single post from an url in the ~/Pictures directory:

$ instalooter post "https://www.instagram.com/p/BFB6znLg5s1/" ~/Pictures

Use a configuration file to download from several account using custom parameters (see Batch mode):

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

See more on the Usage page of the online documentation.

Metadata

Release files for instalooter 2.4.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for instalooter 2.4.4
File Size Uploaded
instalooter-2.4.4.tar.gz 450.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for instalooter 2.4.4
File Interpreter ABI Platform
instalooter-2.4.4-py2.py3-none-any.whl Python 3, Python 2 none any Details

Total release size: 496.2 kB

Release files / instalooter-2.4.4.tar.gz

Download URL instalooter-2.4.4.tar.gz
Size 450.6 kB
Tags Source
SHA-256 checksum
How to use checksums
fb9b4a948702361a161cc42e58857e3a6c9dafd9e22568b07bc0d0b09c3c34a9
BLAKE2b-256 checksum
How to use checksums
3013907e6aaba6280e1001080ab47e750068ffc5fb7174203985b3c9d678e3f2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/3.8.3

Release files / instalooter-2.4.4-py2.py3-none-any.whl

Download URL instalooter-2.4.4-py2.py3-none-any.whl
Size 45.6 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
99d477fb12c2aa3fa3951218ef175d817cf556b5d971d11a7fe78d42368e0889
BLAKE2b-256 checksum
How to use checksums
4bac050c36a8384b4aeda24f12faaf677e17921db161930167da9d75faad9d09
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/3.8.3

Release history Release notifications | RSS feed

This release

2.4.4 This release

2 release files

2.4.3

2 release files

2.4.2

2 release files

2.4.1

2 release files

2.4.0

2 release files

2.3.4

2 release files

2.3.3

2 release files

2.3.2

2 release files

2.3.1

2 release files

2.3.0

2 release files

2.2.0

2 release files

2.1.0

2 release files

2.0.3

2 release files

2.0.2

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.0.0

2 release files

0.14.0

2 release files

0.13.3

2 release files

0.13.2

2 release files

0.13.1

2 release files

0.13.0

2 release files

0.12.0

3 release files

0.11.0

2 release files

0.10.2

2 release files

0.10.1

2 release files

0.9.9

2 release files

0.9.8

2 release files

0.9.7

2 release files

0.9.6

2 release files

0.9.4

2 release files

0.9.3

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.2

2 release files

0.8.1

2 release files

0.8.0

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page