instalooter 0.3.1

Another API-less Instagram pictures and videos downloader.

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

Requirements

BeautifulSoup	HTML parsing
docopt	CLI arguments parsing
progressbar2	Dynamic output in CLI
requests	HTTP handling
six	Python 2/3 compatibility

Usage

InstaLooter comes with its CLI:

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

Arguments

• username

  the username of the instagram account to download pictures and videos from.

• hashtag

  the hashtag to download pictures and videos from.

• directory

  the directory to download files into.

Options

• -n NUM, --num-to-dl NUM

  number of maximum new posts to download (if not specified all posts are downloaded).

• -m, --add-metadata

  add date and caption metadata to downloaded pictures (requires piexif and PIL/Pillow)

• -v, --get-videos

  also download videos.

• -j JOBS, --jobs JOBS

  the number of parallel threads to use to download files. It is advised to use a value of at least 12 as Instagram profile pages display 12 medias at a time in order to insure parallel download of all files. [default: 16]

• -c CRED, --credentials CRED

  the login and password to use to login to Instagram, if needed (for instance: downloading medias from a private account you follow). [format: login:password]

• -q, --quiet

  do not produce any output.

Installation

From PyPI

$ pip install instaLooter  # requires super-user rights

From GitHub

$ git clone https://github.com/althonos/InstaLooter
$ cd InstaLooter
$ pip install .            # requires super-user rights