Skip to content

M4elstr0m/instagramer

Repository files navigation

InstagramExportReader

A tool to analyze Instagram information exports

By M4elstr0m.

About

Origins

InstagramExportReader -> InstagramER -> instagramer 😎

Disclaimer

  • This software does not interact directly with Instagram and is purely using local ressources (your .zip export) to analyze data.
  • You can check for updates anytime using instagramer --check-update. It does not check for update on start-up for performance concerns
  • This C# software has been compiled using AOT for maximum runtime performance

Features

Retrieve, process and display these informations from an Instagram export:

  • Total users found in the export
  • Followers count
  • Following count
  • Followers/Following rate
  • Mutual follows
  • Users you don't follow back
  • Users not following you back
  • Detailed list of every Instagram relations you have

Use-it

To get the standard helping message

instagramer --help

To get a complete walkthrough (tutorial mode)

instagramer --tutorial

To get a bunch of useful command examples

instagramer --examples

Install-it

🪟 Windows Installation

  1. Download a win-x64 release
  2. Extract the archive

⚠️ If you are okay with always staying in the same file to use the software, you can already open a Terminal in the .exe folder and start using it. However I highly recommend following the steps below to add the binary to your system's environment variables, making it accessible from anywhere by just typing instagramer in your terminal.

  1. Move your .exe to a dedicated folder (e.g., C:\Apps\InstagramExportReader)
  2. Press the Windows Key and type "Env"
  3. Select Edit the system environment variables
  4. Click Environment Variables at the bottom
  5. Under "User variables" (top scrollable panel), find "Path", select it, and click Edit
  6. Click New and paste the path to your folder: (e.g., C:\Apps\InstagramExportReader)
  7. Restart your terminal

Now, instagramer --help will work instantly from anywhere in your Windows terminal!

🐧 Linux Installation

  1. Download a linux-x64 release
  2. Extract the archive
  3. Run sudo ./install.sh

At the end, the install script will verify your installation by running instagramer --help

Build-it

All-At-Once

This script is basically all the build commands below gathered in a single file

./publish.ps1

🪟 Windows Build

dotnet publish -r win-x64 -c Release

🐧 Linux Build (🐳 Docker)

⚠️ Why Docker? Please refer to the 3rd disclaimer

⚠️ You MUST have DockerDesktop actively running on your system

docker run --rm -v "${PWD}:/app" -w /app mcr.microsoft.com/dotnet/sdk:10.0-preview `
    bash -c "apt update && apt install -y clang zlib1g-dev && dotnet publish -r linux-x64 -c Release"

Screenshots

Output for `instagramer --help` using v1.0.0

Roadmap

  • Dynamic column number
  • Split ProcessTargets() and its progress bar UI
  • Flag to export to JSON (counters only)