🧹 IG-CLEANER

IG‑Cleaner is a terminal-based Python automation tool designed to help you clean up your Instagram account more efficiently. It allows you to automatically unfollow accounts in bulk, remove users who don’t follow you back, and export your followers/following lists for further analysis — all from a simple command-line interface. Ideal for personal cleanup or account optimization, IG‑Cleaner helps you regain control of your social graph with minimal effort.

📖 Table of Contents

• 🔍 Overview
• 🛠 Features
• 📎 Requirements
• 📦 Installation
• 💡 Usage
  • 🔄 Auto Unfollow All Followers
  • 🚫 Auto Unfollow Non‑Followers Only
  • 📤 Export Follower/Following List
• ⚙️ Settings & Limits
• 📋 Logging
• 🧯 Safety Guidelines
• 🤝 Contributing
• 🧾 License

🔍 Overview

IG‑Cleaner is a terminal-based Python tool that simplifies Instagram cleanup through automated unfollowing and exporting features. Built with selenium, enhanced by rich for UI, and designed with safety in mind, it ensures fast and controlled sessions.

🛠 Features

• Auto Unfollow All Followers: Remove everyone you're following in batches.
• Auto Unfollow Non-Followers: Only unfollow users who don't follow you back.
• Export Data: Save lists of followers/followings for analysis.
• Configurable Limits: Use settings.json to adjust batch size, delays, and cooldowns.
• Stylish CLI: Colorful branding and prompts using rich.
• Daily Log Rotation: Keep organized records with automated date-based separation.

📎 Requirements

• Python 3.8+
• selenium
• rich
• pandas
• Chrome + matching chromedriver in the drivers/ directory.

📦 Installation

git clone https://github.com/denoyey/IG-Cleaner.git
cd IG-Cleaner
pip install selenium rich pandas --break-system-packages

Place chromedriver binary under drivers/, matching your OS.
(Optional) Customize settings via settings.json.

💡 Usage

python ig_cleaner.py

Menu-based interface will appear:

🔄 Auto Unfollow All Followers:

Batch-unfollow all users you're following, with delays and cooldowns to reduce risk.

🚫 Auto Unfollow Non‑Followers Only:

Unfollow only users who don't reciprocate, up to a safe limit per session.

📤 Export Follower/Following List:

Save follower/following usernames to files, supporting later review or custom actions.

⚙️ Settings & Limits

Customize behavior via settings.json, with the following options:

{
  "MAX_SAFE_LIMIT": 150,
  "BATCH_DELAY": 20,
  "SLEEP_BETWEEN": [2, 5],
  "SLEEP_AFTER_BATCH": 60
}

Defaults will be used if the file is missing.

📋 Logging

Logs are saved in log/logfile.log, with daily separation if dates change. The tool automatically alerts if log files exceed 500 KB and resets them to keep output clean.

🧯 Safety Guidelines

• Always review Instagram's automation policies.
• Use conservative batch sizes and delays to minimize detection risk.
• Best to test on a secondary or test account.
• Manual login required—logout from other sessions to avoid conflicts.

🤝 Contributing

Contributions are welcome! Please follow the steps:

1. Fork the repo
2. Create a feature branch
3. Submit a pull request with clear description

🧾 License

Released under the MIT License. See the LICENSE file for details.