🧹 Telegram Chat Cleaner

Effortlessly declutter your Telegram chats by automatically leaving, deleting, and silencing the noise — all from one script.
Built with 💖 by Design Synchrony & abreel.

---

🚀 Features

• Lists all your current chats
• Keeps only the ones you specify
• Leaves Telegram groups/channels
• Deletes chats and chat history
• Saves you from Telegram chaos ✨

---

📦 Requirements

• Python 3.8+
• Telethon
• python-dotenv
• Telegram API credentials (get yours from my.telegram.org)

---

⚙️ Installation

git clone https://github.com/Designsynchronyorg/Telegram-Cleanup.git
cd telegram-chat-cleaner

pip install -r requirements.txt

---

🔐 Setup

Create a .env file in the root of the project:

API_ID=your_api_id
API_HASH=your_api_hash

💡 Don’t know where to get these? Log in at my.telegram.org → API Development → Create a new app.

---

▶️ Usage

python main.py

You’ll see a list of all your chats, like so:

🧾 ALL CHATS:
- Cool Group
- Work Stuff
- Random Channel

Then enter the names you want to keep, comma-separated:

📌 Enter chat/group/channel names to KEEP (comma-separated): Work Stuff

That’s it — we’ll sweep through and leave/delete everything else! 🧹

---

📸 Screenshot

🧾 ALL CHATS:
- Cat Memes Central
- Project Alpha
- Spamzilla News

📌 Enter chat/group/channel names to KEEP (comma-separated): Project Alpha

✅ Keeping: Project Alpha
👋 Leaving: Cat Memes Central
🗑️ Deleting chat: Cat Memes Central
👋 Leaving: Spamzilla News
🗑️ Deleting chat: Spamzilla News

✅ Done! Deleted 2 chats not in your keep list.

---

✨ Credits

Big thanks to:

• Design Synchrony – Branding, tools & testing
• abreel – Core scripting & concept

---

☠️ Warning

This script actually leaves and deletes chats. No take-backs. No regrets. So be sure about what you’re keeping before you hit enter.

---

📄 License

MIT — Do what you want, just don’t sue us 😎