Skip to content

AshFahim/Instagram-Unfollowers-Checker-Manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“Š Instagram Unfollowers Checker & Manager

A Tampermonkey userscript that helps you identify and manage Instagram accounts that don't follow you back. Features a beautiful, modern interface with advanced safety mechanisms and bulk management capabilities.

✨ Features

πŸ” Smart Detection

  • Automatic Scanning: Analyzes your entire following list to find non-followers
  • Real-time Progress: Live progress bar with animated effects
  • Accurate Results: Uses Instagram's official GraphQL API for reliable data
  • Visual Feedback: Modern UI with Instagram-inspired design

πŸ‘₯ User Management

  • πŸ‘οΈ View Profiles: Quick access to user profiles in new tabs
  • πŸ‘‹ Individual Unfollow: One-click unfollowing with confirmation dialogs
  • 🚫 Bulk Unfollow: Mass unfollow option with safety confirmations
  • βœ… Visual Status: Cards change color to show unfollow status

πŸ›‘οΈ Advanced Safety Features

  • 🎯 Dual-Layer Rate Limiting:
    • Random delays (1-1.4 seconds) between each request
    • Enhanced pauses (10-15 seconds) every 10 accounts checked
  • ⚠️ Confirmation Dialogs: Double-check for all unfollow actions
  • πŸ”„ Error Handling: Graceful error recovery and retry logic
  • πŸ“Š Progress Tracking: Real-time updates during all operations

πŸ’Ύ Data Management

  • πŸ“₯ Export Feature: Download unfollowers list as JSON with timestamps
  • πŸ“± Responsive Design: Works perfectly on all screen sizes
  • 🎨 Modern UI: Beautiful gradients and smooth animations
  • πŸŒ™ User-Friendly: Intuitive interface requiring no technical knowledge

πŸš€ Installation

Prerequisites

  1. Tampermonkey Extension: Install from Chrome Web Store or Firefox Add-ons

Installation Steps

  1. Copy the Script: Open script.js and copy all the code
  2. Create New Script:
    • Click Tampermonkey icon β†’ "Create a new script"
    • Delete the default content
    • Paste the copied code
  3. Save: Press Ctrl+S or click the save icon
  4. Enable: Make sure the script is enabled in Tampermonkey dashboard

πŸ“± How to Use

🎯 Getting Started

  1. Login to Instagram: Visit instagram.com and log in
  2. Find the Button: Look for the floating "πŸ” Check Unfollowers" button in the top-right corner
  3. Start Analysis: Click the button to begin scanning your followers

πŸ” During Analysis

  • Progress Tracking: Watch the real-time progress bar and statistics
  • Safety Pauses: Script automatically pauses every 10 accounts for 10-15 seconds
  • Live Updates: See unfollowers being discovered in real-time
  • Completion Summary: Get final statistics when analysis is complete

πŸ‘₯ Managing Unfollowers

  • πŸ‘οΈ View Profile: Click "View" to open user's Instagram profile
  • πŸ‘‹ Individual Unfollow: Click "Unfollow" β†’ Confirm β†’ User is unfollowed
  • 🚫 Bulk Unfollow: Click "Unfollow All" β†’ Double confirm β†’ Mass unfollow with progress
  • πŸ“₯ Download Data: Save the complete list as a JSON file

βš™οΈ Script Configuration

πŸ›‘οΈ Rate Limiting Settings

// Regular delays (1-1.4 seconds between requests)
await sleep(Math.floor(Math.random() * 400) + 1000);

// Enhanced safety pause (10-15 seconds every 10 accounts)
if (accountsChecked % 10 === 0) {
  const extendedWait = Math.floor(Math.random() * 5000) + 10000;
  await sleep(extendedWait);
}

🎨 UI Customization

The script uses CSS-in-JS for styling. Key elements:

  • Button Position: top: 20px; right: 20px;
  • Modal Size: max-width: 700px; width: 95%;
  • Color Scheme: Instagram gradient (#833ab4, #fd1d1d, #fcb045)

πŸ”§ Technical Details

πŸ“‘ API Endpoints Used

  • Following List: https://www.instagram.com/graphql/query/?query_hash=3dec7e2c57367ef3da3d987d89f9dbc8
  • Unfollow Action: https://www.instagram.com/web/friendships/{userId}/unfollow/

πŸͺ Required Cookies

  • csrftoken: For authentication
  • ds_user_id: Your Instagram user ID

πŸ“Š Data Structure

// Unfollower object structure
{
  id: "user_id",
  username: "username",
  full_name: "Display Name",
  profile_pic_url: "https://...",
  is_verified: boolean,
  follows_viewer: false
}

⚠️ Important Notes

πŸ›‘οΈ Safety Guidelines

  • Use Responsibly: Don't run the script multiple times in quick succession
  • Respect Rate Limits: The built-in delays are essential for avoiding blocks
  • Backup Data: Always download your unfollowers list before bulk operations
  • Account Safety: Instagram may temporarily limit your account if you unfollow too many users

⚑ Performance Tips

  • Close Other Tabs: Reduce browser load for better performance
  • Stable Internet: Ensure stable connection for uninterrupted scanning
  • Fresh Login: Re-login if you encounter authentication errors
  • Desktop Recommended: Better experience on desktop vs mobile

🚨 Troubleshooting

  • Button Not Appearing: Refresh the page and wait 2-3 seconds
  • Login Required: Make sure you're logged into Instagram
  • Fetch Errors: Check internet connection and try again
  • Rate Limited: Wait 10-15 minutes before running again

πŸ“‹ Version History

πŸ†• Version 2.0 (Current)

  • βœ… Enhanced rate limiting (10-15 second pauses every 10 accounts)
  • βœ… Improved UI with better visual feedback
  • βœ… Bulk unfollow functionality with progress tracking
  • βœ… Better error handling and recovery
  • βœ… Modern responsive design

πŸ“œ Version 1.0

  • βœ… Basic unfollower detection
  • βœ… Individual unfollow capability
  • βœ… JSON export functionality
  • βœ… Basic rate limiting

🀝 Contributing

Feel free to contribute improvements, bug fixes, or new features:

  1. Fork the Repository
  2. Create Feature Branch: git checkout -b feature/amazing-feature
  3. Commit Changes: git commit -m 'Add amazing feature'
  4. Push to Branch: git push origin feature/amazing-feature
  5. Open Pull Request

πŸ“„ License

This project is for educational purposes. Use responsibly and in accordance with Instagram's Terms of Service.

⚠️ Disclaimer

  • This script interacts with Instagram's web interface
  • Instagram may change their API at any time, potentially breaking the script
  • Use at your own risk and responsibility
  • The developers are not responsible for any account restrictions or bans
  • Always respect Instagram's Terms of Service and Community Guidelines

πŸ™ Acknowledgments

Took help from https://github.com/ann0nip


⭐ If this script helped you, please give it a star!

πŸ› Found a bug? Please report it in the issues section.

πŸ’‘ Have suggestions? We'd love to hear them!