A Python tool for reporting Telegram channels that violate Telegram's Terms of Service using multiple accounts simultaneously.
This tool is intended for legitimate reporting of channels that violate Telegram's Terms of Service. Do not use this tool for harassment, spam, or malicious purposes. The authors are not responsible for any misuse of this software. Use responsibly and in accordance with Telegram's Terms of Service.
- Multi-account support: Add and manage multiple Telegram accounts
- Batch reporting: Report channels using all configured accounts simultaneously
- Multiple report reasons: Support for various violation types (spam, violence, etc.)
- Session management: Secure session storage for persistent logins
- Colorized output: Easy-to-read console output with color coding
- Error handling: Robust error handling for network issues and invalid inputs
- Python 3.7 or higher
- Telegram API credentials (api_id and api_hash)
- Valid Telegram account(s) with phone numbers
apt update && apt upgrade
pkg install python3 python3-pip git -y
git clone https://github.com/Mr3rf1/TelReper
cd TelReper
pip3 install telethon colorama
python3 reper.pysudo apt update && sudo apt upgrade
sudo apt install python3 python3-pip git -y
git clone https://github.com/Mr3rf1/TelReper
cd TelReper
pip3 install telethon colorama
python3 reper.py- Install Python 3.7+ from python.org
- Download or clone this repository
- Open Command Prompt/PowerShell in the project directory
- Run:
pip install telethon colorama python reper.py
-
Get Telegram API credentials:
- Go to my.telegram.org
- Log in with your phone number
- Go to "API Development Tools"
- Create a new application
- Copy your
api_idandapi_hash
-
Update API credentials:
- Open
reper.py - Replace the
api_idandapi_hashvalues with your credentials:
api_id = YOUR_API_ID api_hash = 'YOUR_API_HASH'
- Open
Before reporting, you need to add at least one Telegram account:
python reper.py -an +1234567890Replace +1234567890 with your actual phone number (include country code).
python reper.py -r 100 -t channelname -m spamParameters:
-r, --run: Number of reports to send-t, --target: Target channel username (without @)-m, --mode: Report reason (see available reasons below)
python reper.py -reSupported reasons:
spam- Spam contentfake_account- Fake account/impersonationviolence- Violent contentchild_abuse- Child abuse contentpornography- Pornographic contentgeoirrelevant- Geographically irrelevant content
python reper.py -h| Option | Long Form | Description | Example |
|---|---|---|---|
-an |
--add-number |
Add a new account | -an +1234567890 |
-r |
--run |
Number of reports to send | -r 50 |
-t |
--target |
Target channel (without @) | -t spamchannel |
-m |
--mode |
Report reason | -m spam |
-re |
--reasons |
Show available reasons | -re |
-h |
--help |
Show help message | -h |
TelReper/
├── reper.py # Main application file
├── sessions/ # Directory for session files (auto-created)
│ ├── Ac1.session # Session file for account 1
│ ├── Ac2.session # Session file for account 2
│ └── ...
└── README.md # This file
- Session files contain sensitive authentication data - keep them secure
- Never share your session files or API credentials
- The tool stores sessions locally in the
sessions/directory - Each account gets its own session file (Ac1.session, Ac2.session, etc.)
"The phoneNumber was invalid!"
- Ensure you include the country code (e.g., +1 for US)
- Use the format: +[country_code][phone_number]
"The link of channel was invalid!"
- Make sure the channel username is correct
- Don't include the @ symbol
- Ensure the channel exists and is public
Connection errors
- Check your internet connection
- Telegram servers might be temporarily unavailable
- Try again after a few minutes
If you encounter issues:
- Check the error message carefully
- Ensure all requirements are installed
- Verify your API credentials are correct
- Make sure you have at least one account added
This tool is compatible with Telethon 1.40.0 and uses the latest Telegram API methods. The reporting system has been updated to work with Telegram's current API structure.
This project is provided as-is for educational and legitimate reporting purposes only. Users are responsible for complying with all applicable laws and Telegram's Terms of Service.
Contributions are welcome! Please ensure any contributions maintain the tool's legitimate purpose and include appropriate documentation.
- Built with Telethon - Python Telegram client library
- Uses Colorama for colored terminal output
- Original concept by @Mr3rf1
Remember: Use this tool responsibly and only for legitimate reporting of Terms of Service violations.