# instant-liberation

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

Latest version **0.13.0** (published 2020-06-23) · Unlicense license · 0 weekly downloads

## Install

```sh
npm install instant-liberation
pnpm add instant-liberation
yarn add instant-liberation
bun add instant-liberation
```

Provides the command `instalib`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.13.0 |
| Published | 2020-06-23 |
| First published | 2019-04-09 |
| Weekly downloads | 0 |
| License | Unlicense |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=10 |
| Dependencies | 7 |
| Unpacked size | 12.6 KB |
| Known vulnerabilities | 0 (+13 in 4 direct dependencies) |
| Install scripts | no |
| GitHub stars | 4 |
| Author | Lynn Smeria |
| Maintainers | aengl |

## Links

- npm: https://www.npmjs.com/package/instant-liberation
- Repository: https://github.com/aengl/instant-liberation
- Homepage: https://github.com/aengl/instant-liberation#readme
- Issues: https://github.com/aengl/instant-liberation/issues
- npm.io page: https://npm.io/package/instant-liberation

## Dependencies (7)

- [got](https://npm.io/package/got.md) 11.3.0
- [debug](https://npm.io/package/debug.md) 4.1.1
- [lodash](https://npm.io/package/lodash.md) 4.17.15
- [caporal](https://npm.io/package/caporal.md) 1.4.0
- [js-yaml](https://npm.io/package/js-yaml.md) 3.14.0
- [fs-extra](https://npm.io/package/fs-extra.md) 9.0.1
- [puppeteer](https://npm.io/package/puppeteer.md) 4.0.0

## Recent versions

- 0.13.0 (latest) — 2020-06-23
- 0.12.0 — 2019-08-27
- 0.11.0 — 2019-07-11
- 0.10.0 — 2019-04-09

## README

# 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](https://nodejs.org/en/download/) is installed and up-to-date:

    ```
    brew install node
    ```

1.  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.

---
_Source: https://npm.io/package/instant-liberation · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._