instaLooter supports a batch mode for use cases that are more requiring than
just download from a profile once or twice. To use it, you must specify a
batch config file to the CLI. The file is in the Python configuration format,
very close to the Windows INI format.
A config file contains at least one section, but can contain more if needed.
A section is organised as shown below, with a header and key-value pairs using
[my section header] key = value other_key = other_value
Users can be specified in the users parameter of each section, and hashtags
in the hashtags parameter. Those sections take a
key: value pair per line,
where key is the name of the user, and value the path to the directory where
the medias will be downloaded. For instance:
[Video Games] users = borderlands: /tmp/borderlands ffxv: /tmp/ffxv hashtags = nierautomata: /tmp/nier [Music] users = perm36 : ~/Music/Perm36
Each section can be provided with a
username and a
if none are given, the scraping is done anonymously or using the last session you logged with (through
instaLooter loginfor instance, or the session of the previous section).
instaLooterwill interactively ask for the associated password and then login.
passwordare given, then
instaLooterwill logout from any previous session and login quietly.
Each section can be given the same parameters as the command line:
set to True to add metadata to the downloaded images
set to True to download videos as well as images
the number of threads to use, defaults to
the template to use, without quotes, defaults to
set to True to download only videos
set to True to hide the progress bar
set to True to only download new medias
the number of images to download
set to True to dump metadata in JSON format
set to True to only dump metadata, not downloading anything.
set to True to fetch additional information when dumping metadata.
For instance, to download 3 new videos from
[Vids] videos-only = true new = true num-to-dl = 3 hashtags = funny: ~/Videos nsfw: ~/Videos
Running the program¶
Simply run the following command
instaLooter batch /path/to/your/batch.ini