Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Telegram Cleaner

Ever joined hundreds of Telegram groups, channels, and bots over the years — and now your chat list is a mess? This tool lets you clean your entire Telegram account in one click instead of leaving each one manually.

Python Telethon


The Problem

Over time, Telegram fills up with:

  • Groups you joined and forgot about
  • Channels you subscribed to but never read
  • Bots you tested once and never used again

Cleaning them manually means opening each chat, going to settings, and leaving/deleting one by one. With hundreds of chats, that takes forever.

The Solution

Telegram Cleaner scans your entire account and shows you everything in a checklist. You tick what you want gone, hit Execute, and it's all removed at once.

  • ✅ Leave groups and channels you're subscribed to
  • ✅ Delete bot conversations and their full chat history
  • ✅ Select all with one click, or pick manually
  • ✅ Your own channels and private conversations are never touched

Setup

1. Get Telegram API credentials

Go to my.telegram.org, log in, and create an app to get your API_ID and API_HASH.

2. Install dependencies

pip install -r requirements.txt

3. Configure credentials

Copy .env.example to .env and fill in your values:

cp .env.example .env
API_ID=your_api_id_here
API_HASH=your_api_hash_here
PHONE=+1234567890

4. Run

python Cleaner.py

On the first run you'll be asked for the Telegram verification code sent to your phone. If you have 2FA enabled, you'll also enter your password. After that, a session file is saved and future runs skip the login step.


How to Use

  1. The app loads all your bots (🤖) and groups/channels (📢)
  2. Tick everything you want to remove
  3. Use Select All to tick everything at once
  4. Click the red Execute button and confirm
  5. Done — your Telegram is clean

How it Works

Type What happens
🤖 Bot Full chat history deleted on both sides
📢 Channel You leave the channel
👥 Group You are removed from the group

Your own channels and direct messages with real people are never shown or affected.

About

Bulk-remove Telegram bots and group/channel memberships via a desktop GUI

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages