Another API-less Instagram pictures and videos downloader

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for althonos from gravatar.com althonos

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: GNU General Public License v3 (GPLv3) (GPLv3)
  • Author: Martin Larralde
  • Tags instagram, download, web, web scraping, looter
  • Requires: Python >= 2.7, != 3.0.*, != 3.1.*, != 3.2.*
Classifiers
Report project as malware

Project description

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

dateutil

Date manipulation

PyPI dateutil

Source dateutil

License dateutil

hues

Colored output

PyPI hues

Source hues

License hues

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

pip install --user instaLooter

Usage

InstaLooter comes with its CLI:

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

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 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):

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

See more on the Usage page of the online documentation.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page