instalooter 0.4.0

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
dateutil	Date manipulation

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.

• -t TIME, --time TIME

  the timeframe within which to download pictures and videos [format: start:stop]. The parameter can be either a combination of start and stop date in ISO format (e.g. 2016-12-21:2016-12-18, 2015-03-07:, :2016-08-02) or a special value among: thisday, thisweek, thismonth, thisyear. Edges are included in the time frame, so if using the following value: --time 2016-05-10:2016-04-03, then all medias will be downloaded including the ones posted on the 10th of May 2016 and on the 3rd of April 2016.

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