instant-liberation

Instant Liberation

Want to leave Instagram, or integrate a feed on your website in a GDPR friendly way?

This project offers you a CLI that can download data from instagram and mirror its contents, even for private profiles.

Installation

1. Make sure Node.js is installed and up-to-date:

   brew install node

2. Install instalib globally via npm:

   npm install -g instant-liberation

   If you can't or don't want to install it globally, just drop the -g flag and either create the instalib command in your package.json, or run it with npx instalib.

Usage

• Store session (for private profiles):

  instalib login

  A browser will open. Simply log in and close the browser window again. Your session is now cached until it expires.

  The session information will be saved in your home directory in ~/.instalib. The folder can be removed at any point and is not used for anything else.

• Download profile data:

  instalib liberate <url_to_profile> -o instagram.yml

• Mirror images and videos:

  instalib mirror instagram.yml

  Only detail.display_url is mirrored by default (the full size images). If you want to mirror additional files, just call the command repeatedly with different flags, e.g.:

  instalib mirror instagram.yml -f detail.display_url -o media/images/
  instalib mirror instagram.yml -f detail.video_url -o media/videos/

  Once downloaded, the field in the data file will be replaced by the relative path to the downloaded file. If the command fails due to an Instagram block, simply re-run the command again and it will skip already downloaded files.