{"id":30666801,"url":"https://github.com/denoyey/ig-cleaner","last_synced_at":"2026-05-14T23:33:16.768Z","repository":{"id":311089383,"uuid":"1042429357","full_name":"denoyey/IG-Cleaner","owner":"denoyey","description":"Instagram CLI tool for bulk unfollowing, exporting data, and managing non-followers.","archived":false,"fork":false,"pushed_at":"2025-08-22T03:12:12.000Z","size":19734,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-22T04:26:13.436Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/denoyey.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-22T02:23:40.000Z","updated_at":"2025-08-22T03:12:16.000Z","dependencies_parsed_at":"2025-08-22T04:36:19.317Z","dependency_job_id":null,"html_url":"https://github.com/denoyey/IG-Cleaner","commit_stats":null,"previous_names":["denoyey/ig-cleaner"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/denoyey/IG-Cleaner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/denoyey%2FIG-Cleaner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/denoyey%2FIG-Cleaner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/denoyey%2FIG-Cleaner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/denoyey%2FIG-Cleaner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/denoyey","download_url":"https://codeload.github.com/denoyey/IG-Cleaner/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/denoyey%2FIG-Cleaner/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273047513,"owners_count":25036379,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-31T02:00:09.071Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2025-08-31T22:16:57.607Z","updated_at":"2026-05-14T23:33:16.713Z","avatar_url":"https://github.com/denoyey.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \n# 🧹 IG-CLEANER\n\n\u003cp align=\"center\"\u003e\n\u003cstrong\u003eIG‑Cleaner\u003c/strong\u003e is a terminal-based Python automation tool designed to help you clean up your Instagram account more efficiently.\nIt 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.\nIdeal for personal cleanup or account optimization, IG‑Cleaner helps you regain control of your social graph with minimal effort.\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n![Build](https://img.shields.io/badge/build-stable-28a745?style=for-the-badge\u0026logo=github)\n![Platform](https://img.shields.io/badge/platform-Linux-0078D6?style=for-the-badge\u0026logo=linux\u0026logoColor=white)\n![Last Commit](https://img.shields.io/github/last-commit/denoyey/IG-Cleaner?style=for-the-badge\u0026logo=git)\n![Language](https://img.shields.io/github/languages/top/denoyey/IG-Cleaner?style=for-the-badge\u0026color=informational)\n![Technologies](https://img.shields.io/badge/technologies-%20Python-yellow?style=for-the-badge\u0026logo=terminal)\n![Stars](https://img.shields.io/github/stars/denoyey/IG-Cleaner?style=for-the-badge\u0026color=ffac33\u0026logo=github)\n![Forks](https://img.shields.io/github/forks/denoyey/IG-Cleaner?style=for-the-badge\u0026color=blueviolet\u0026logo=github)\n![Issues](https://img.shields.io/github/issues/denoyey/IG-Cleaner?style=for-the-badge\u0026logo=github)\n![Contributors](https://img.shields.io/github/contributors/denoyey/IG-Cleaner?style=for-the-badge\u0026color=9c27b0)\n\n\u003cbr /\u003e\n\n\u003cimg src=\"https://api.visitorbadge.io/api/VisitorHit?user=denoyey\u0026repo=IG-Cleaner\u0026countColor=%237B1E7A\u0026style=flat-square\" alt=\"visitors\"/\u003e\n\n\u003c/div\u003e\n\n\u003c/div\u003e\n\n## 📖 Table of Contents\n\n- [🔍 Overview](#-overview)\n- [🛠 Features](#-features)\n- [📎 Requirements](#-requirements)\n- [📦 Installation](#-installation)\n- [💡 Usage](#-usage)\n  - [🔄 Auto Unfollow All Followers](#-auto-unfollow-all-followers)\n  - [🚫 Auto Unfollow Non‑Followers Only](#-auto-unfollow-nonfollowers-only)\n  - [📤 Export Follower/Following List](#-export-followerfollowing-list)\n- [⚙️ Settings \u0026 Limits](#%EF%B8%8F-settings--limits)\n- [📋 Logging](#-logging)\n- [🧯 Safety Guidelines](#-safety-guidelines)\n- [🤝 Contributing](#-contributing)\n- [🧾 License](#-license)\n\n## 🔍 Overview\n\nIG‑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.\n\u003cp align=\"left\"\u003e\n  \u003cimg src=\"https://github.com/denoyey/IG-Cleaner/blob/3c4ce28a5ac11d0f960eeea91df3c3803f9ecdc1/img/Review-Tools.png\" alt=\"IG-Cleaner\"/\u003e\n\u003c/p\u003e\n\n## 🛠 Features\n\n-  **Auto Unfollow All Followers**: Remove everyone you're following in batches.\n-  **Auto Unfollow Non-Followers**: Only unfollow users who don't follow you back.\n-  **Export Data**: Save lists of followers/followings for analysis.\n-  **Configurable Limits**: Use `settings.json` to adjust batch size, delays, and cooldowns.\n-  **Stylish CLI**: Colorful branding and prompts using `rich`.\n-  **Daily Log Rotation**: Keep organized records with automated date-based separation.\n\n## 📎 Requirements\n\n- Python 3.8+\n- `selenium`\n- `rich`\n- `pandas`\n- Chrome + matching `chromedriver` in the `drivers/` directory.\n\n## 📦 Installation\n\n```bash\ngit clone https://github.com/denoyey/IG-Cleaner.git\ncd IG-Cleaner\npip install selenium rich pandas --break-system-packages\n```\n\u003e Place chromedriver binary under drivers/, matching your OS. \u003cbr /\u003e\n\u003e (Optional) Customize settings via settings.json.\n\n## 💡 Usage\n\n```bash\npython ig_cleaner.py\n```\nMenu-based interface will appear:\n#### 🔄 Auto Unfollow All Followers: \n\u003e Batch-unfollow all users you're following, with delays and cooldowns to reduce risk.\n#### 🚫 Auto Unfollow Non‑Followers Only: \n\u003e Unfollow only users who don't reciprocate, up to a safe limit per session.\n#### 📤 Export Follower/Following List: \n\u003e Save follower/following usernames to files, supporting later review or custom actions.\n\n## ⚙️ Settings \u0026 Limits\n\nCustomize behavior via settings.json, with the following options:\n```json\n{\n  \"MAX_SAFE_LIMIT\": 150,\n  \"BATCH_DELAY\": 20,\n  \"SLEEP_BETWEEN\": [2, 5],\n  \"SLEEP_AFTER_BATCH\": 60\n}\n```\n\u003e Defaults will be used if the file is missing.\n\n## 📋 Logging\n\nLogs 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.\n\n## 🧯 Safety Guidelines\n\n- Always review Instagram's automation policies.\n- Use conservative batch sizes and delays to minimize detection risk.\n- Best to test on a secondary or test account.\n- Manual login required—logout from other sessions to avoid conflicts.\n\n## 🤝 Contributing\n\nContributions are welcome! Please follow the steps:\n1. Fork the repo\n2. Create a feature branch\n3. Submit a pull request with clear description\n\n## 🧾 License\n\nReleased under the **MIT License**. See the \u003ca href=\"https://raw.githubusercontent.com/denoyey/IG-Cleaner/refs/heads/main/LICENSE\"\u003eLICENSE\u003c/a\u003e file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdenoyey%2Fig-cleaner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdenoyey%2Fig-cleaner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdenoyey%2Fig-cleaner/lists"}