Skip to content

πŸ” Privacy-first Instagram data analyzer. Upload your data export, discover unfollowers, view connections, explore your content - all processed locally in your browser. No servers, no tracking.

Notifications You must be signed in to change notification settings

aminghafuri/toolinsta

Repository files navigation

ToolInsta Logo

ToolInsta

πŸ” Instagram Data Analyzer β€” Privacy First, Always

Transform your Instagram data export into beautiful, organized insights β€” all processed locally in your browser.

Next.js TypeScript Tailwind CSS PWA License

πŸš€ Live Demo Β· πŸ“– Documentation Β· πŸ› Report Bug Β· ✨ Request Feature


πŸ“‹ Table of Contents


🎯 About

ToolInsta is a privacy-focused Instagram data analyzer that helps you explore and understand your Instagram data export. Unlike other tools, ToolInsta processes everything locally in your browser β€” your data never leaves your device.

Whether you want to find out who unfollowed you, explore your posts and stories, or understand your digital footprint, ToolInsta provides a beautiful, intuitive interface to navigate your Instagram data.

Why ToolInsta?

  • πŸ”’ 100% Private: All processing happens in your browser
  • πŸš€ No Server: Your data is never uploaded anywhere
  • πŸ“± PWA Support: Install as a native app on any device
  • πŸŒ™ Dark Mode: Easy on the eyes, day or night
  • πŸ’Ύ Offline Ready: Works without internet after installation

✨ Features

πŸ‘₯ Relationship Analytics

  • Followers & Following Lists β€” View complete lists with timestamps
  • Unfollowers Detection β€” Find people you follow who don't follow back
  • Mutual Friends β€” Discover accounts with reciprocal relationships
  • Not Followed Back β€” Identify followers you haven't followed
  • Blocked Profiles β€” View accounts you've blocked
  • Pending Requests β€” Track follow requests you've sent
  • Recently Unfollowed β€” See who you've recently unfollowed
  • Removed Suggestions β€” View dismissed account suggestions

πŸ“Š Personal Information

  • Profile Details β€” View username, bio, email, and more
  • Profile Photo β€” Display your stored profile picture
  • Account Status β€” Private/public account indicator
  • Contact Information β€” Phone and email details

πŸ“ Location & Interests

  • Locations of Interest β€” Places Instagram associates with you
  • Recommended Topics β€” Topics Instagram thinks you're interested in
  • Profile Changes History β€” Track changes to your profile over time

πŸ“Έ Media Gallery

  • Posts Viewer β€” Browse all your posts with full details
  • Stories Archive β€” View your archived stories
  • Carousel Support β€” Navigate through multi-image posts
  • Video Playback β€” Watch your videos directly
  • Sharing Capabilities β€” Share media directly from the app

πŸ› οΈ Additional Features

  • Smart Search β€” Quick filtering across all lists
  • Sorting Options β€” Sort by name or date
  • Pagination β€” Efficient browsing of large datasets
  • Copy to Clipboard β€” Quick copy usernames
  • Direct Profile Links β€” Open Instagram profiles directly
  • Export/Import Data β€” Save and reload your analysis
  • Responsive Design β€” Works perfectly on all screen sizes

πŸ“± Screenshots

Home Page
Home Page
Beautiful landing with drag & drop upload
Relationship Analytics
Relationship Analytics
Comprehensive follower statistics
Posts and Stories Gallery
Posts & Stories Gallery
Browse your media collection
Personal Information
Personal Information
View your profile details

πŸš€ Getting Started

Prerequisites

Installation

  1. Clone the repository

    git clone https://github.com/aminghafuri/toolinsta.git
    cd toolinsta
  2. Install dependencies

    npm install
    # or
    yarn install
    # or
    pnpm install
  3. Run the development server

    npm run dev
    # or
    yarn dev
    # or
    pnpm dev
  4. Open your browser

    Navigate to http://localhost:3000

Building for Production

npm run build
npm run start

πŸ“– How to Use

Step 1: Export Your Instagram Data

  1. Open Instagram on mobile or web
  2. Go to Settings β†’ Accounts Center
  3. Tap Your information and permissions
  4. Select Export your information β†’ Create export
  5. Choose your account and select Export to device
  6. Set format to JSON (important!)
  7. Wait for Instagram to prepare your data (may take up to 30 days)
  8. Download the ZIP file from the link in your email

Step 2: Upload to ToolInsta

  1. Open ToolInsta
  2. Drag and drop your ZIP file, or click to upload
  3. Wait for extraction to complete
  4. Explore your data!

Tips for Faster Exports

  • ⚑ Uncheck Messages to reduce file size significantly
  • πŸ“· Choose Lower quality for media to speed up download
  • πŸ“… Select All time for complete data coverage

πŸ”’ Privacy & Security

Your Data Stays With You

ToolInsta is designed with privacy as the core principle:

Aspect Implementation
Processing 100% client-side in your browser
Storage Data stored in browser's localStorage only
Network No data is ever sent to any server
Persistence Clear data anytime with one click
Open Source Full source code available for audit

No Analytics, No Tracking

  • ❌ No cookies for tracking
  • ❌ No analytics services
  • ❌ No data collection
  • ❌ No external API calls with your data
  • βœ… Complete transparency

🀝 Contributing

Contributions are welcome! Here's how you can help:

  1. Fork the repository
  2. Create a feature branch
    git checkout -b feature/amazing-feature
  3. Commit your changes
    git commit -m 'Add some amazing feature'
  4. Push to the branch
    git push origin feature/amazing-feature
  5. Open a Pull Request

Development Guidelines

  • Use TypeScript for all new code
  • Follow existing code style and conventions
  • Write self-documenting code with descriptive naming
  • Apply DRY and KISS principles
  • Use Tailwind v4 syntax
  • Ensure components are responsive

Made with ❀️ by Amin Ghafuri

⭐ Star this repo if you find it useful! ⭐

πŸ› Report Bug Β· ✨ Request Feature

About

πŸ” Privacy-first Instagram data analyzer. Upload your data export, discover unfollowers, view connections, explore your content - all processed locally in your browser. No servers, no tracking.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published