https://github.com/denoyey/ig-cleaner
Instagram CLI tool for bulk unfollowing, exporting data, and managing non-followers.
https://github.com/denoyey/ig-cleaner
analytics automation bot chrome-driver cli-tool command-line data-export followers-ig growth-hacking instagram opensource productivity python python-script python3 scraper selenium social-media unfollow
Last synced: about 2 months ago
JSON representation
Instagram CLI tool for bulk unfollowing, exporting data, and managing non-followers.
- Host: GitHub
- URL: https://github.com/denoyey/ig-cleaner
- Owner: denoyey
- License: mit
- Created: 2025-08-22T02:23:40.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2025-08-22T03:12:12.000Z (about 2 months ago)
- Last Synced: 2025-08-22T04:26:13.436Z (about 2 months ago)
- Topics: analytics, automation, bot, chrome-driver, cli-tool, command-line, data-export, followers-ig, growth-hacking, instagram, opensource, productivity, python, python-script, python3, scraper, selenium, social-media, unfollow
- Language: Python
- Homepage:
- Size: 18.8 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🧹 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](#-overview)
- [đź› Features](#-features)
- [đź“Ž Requirements](#-requirements)
- [📦 Installation](#-installation)
- [đź’ˇ Usage](#-usage)
- [🔄 Auto Unfollow All Followers](#-auto-unfollow-all-followers)
- [🚫 Auto Unfollow Non‑Followers Only](#-auto-unfollow-nonfollowers-only)
- [📤 Export Follower/Following List](#-export-followerfollowing-list)
- [⚙️ Settings & Limits](#%EF%B8%8F-settings--limits)
- [đź“‹ Logging](#-logging)
- [🧯 Safety Guidelines](#-safety-guidelines)
- [🤝 Contributing](#-contributing)
- [🧾 License](#-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
```bash
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
```bash
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:
```json
{
"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.