Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/en9inerd/tgeraser
Tool to delete all your messages from chat/channel/conversation on Telegram without requiring admin privileges
https://github.com/en9inerd/tgeraser
automation cleaner cli python telegram telegram-api telethon telethon-based
Last synced: about 1 hour ago
JSON representation
Tool to delete all your messages from chat/channel/conversation on Telegram without requiring admin privileges
- Host: GitHub
- URL: https://github.com/en9inerd/tgeraser
- Owner: en9inerd
- License: mit
- Created: 2019-03-04T01:07:30.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-10-08T04:17:56.000Z (4 months ago)
- Last Synced: 2025-01-23T15:11:11.775Z (7 days ago)
- Topics: automation, cleaner, cli, python, telegram, telegram-api, telethon, telethon-based
- Language: Python
- Homepage:
- Size: 144 KB
- Stars: 35
- Watchers: 1
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
README
# TgEraser
[](https://badge.fury.io/py/tgeraser)
TgEraser is a Python tool that allows you to delete all your messages from a chat, channel, or conversation on Telegram without requiring admin privileges. Official Telegram clients do not provide a one-click solution to delete all your messages; instead, you have to manually select and delete messages, with a limit of 100 messages per batch. TgEraser solves this problem and offers a convenient way to mass-delete your messages on Telegram.
## Installation
```
pip install tgeraser
tgeraser
```
To use TgEraser, you'll need to provide `api_id` and `api_hash`, which you can obtain from [here](https://my.telegram.org/auth?to=apps).
There are two methods to define `api_id` and `api_hash`:
1. Set them as environment variables (`TG_API_ID` and `TG_API_HASH`).
2. Allow the tool to prompt you for input during first execution, with an option to save the credentials in a `credentials.json` file located in the same directory as the sessions (by default, `~/.tgeraser/`).
Credentials file can be created/edited manually in the following format:
```json
{
"api_id": 111111,
"api_hash": "abcdef1234567890abcdef1234567890"
}
```
## Usage
```
TgEraser deletes all your messages from a chat, channel, or conversation on Telegram without requiring admin privileges.
Usage:
tgeraser [(session ) --entity-type TYPE -l NUM [-d PATH] -p PEER_ID -o STRING] | [-k]
tgeraser session -p PEER_ID -t STRING [-o STRING]
tgeraser session -w [--entity-type TYPE -o STRING]
tgeraser -h | --help
tgeraser --version
Options:
-d --directory PATH Specify a directory where your sessions are stored. [default: ~/.tgeraser/]
-w --wipe-everything Delete all messages from all entities of a certain type that you have in your dialog list.
--entity-type TYPE Available types: any, chat, channel, user. [default: chat]
-p --peers PEER_ID Specify certain peers by comma (chat/channel/user).
-l --limit NUM Show a specified number of recent chats.
-t --time-period STRING Specify a period for an infinite loop to run messages deletion every X seconds/minutes/hours/days/weeks.
Example: --time-period "3*days" OR --time-period "5*seconds"
-o --older-than STRING Delete messages older than X seconds/minutes/hours/days/weeks.
Example: --older-than "3*days" OR --older-than "5*seconds"
-k --kill Terminate existing background TgEraser processes (only for Unix-like OS).
-h --help Show this screen.
--version Show version.
```
Executing the tool without options will guide you through the creation of your first user session. After that you can create sessions for multiple users using the `tgeraser session ` command.
## Contributing
If you have any issues or suggestions, please feel free to open an issue or submit a pull request.