Telegram Channel Saver

A Python tool for saving and analyzing Telegram channel content, including messages, users, and media.

Features

• Save channel messages with reactions and media information
• Track channel users and their activity
• Search through saved messages
• Support for multiple Telegram accounts
• Message download with rate limiting and error handling
• Detailed statistics about saved content

Author

Created by Sergey Bulaev - Follow my Telegram channel about AI and technology for more projects and updates.

Installation

1. Clone the repository:

   git clone https://github.com/chubajs/telegram-channel-saver.git
   cd telegram-channel-saver   ```
   

2. Create and activate virtual environment:

   # On Windows
   python -m venv venv
   venv\Scripts\activate
   
   # On macOS/Linux
   python3 -m venv venv
   source venv/bin/activate   ```
   

3. Install required dependencies:

   pip install -r requirements.txt   ```
   

4. Get your Telegram API credentials:
   • Go to https://my.telegram.org/apps
   • Create a new application
   • Note your api_id and api_hash

-5. Set up environment variables (optional):

• On Windows

• set API_ID=your_api_id
• set API_HASH=your_api_hash

• On macOS/Linux

• export API_ID='your_api_id'
• export API_HASH='your_api_hash' +5. Create a .env file in the project root directory:

• Telegram API Credentials

• API_ID=your_api_id # numbers only, no quotes
• API_HASH=your_api_hash # string, no quotes

Usage

1. Run the application:

   python saver.py   ```
   

2. First-time setup:

   • Enter your phone number in international format
   • Enter the verification code sent to your Telegram
   • If you have 2FA enabled, enter your password

3. Main features:

   • List and select channels/groups
   • Save channel messages and users
   • Search through saved content
   • View statistics and user information
   • Manage multiple Telegram sessions

Message Download Options

• Download new messages only
• Force redownload all messages
• Set custom message limits
• Automatic rate limiting to avoid API restrictions

Search Features

• Search by text content
• Search by date range
• Search by message ID
• Filter messages with reactions
• Filter messages with media
• View user's last messages

Data Storage

All data is stored locally in JSON format:

• Messages and reactions
• User information
• Channel/group details
• Session data

Data location: temp/channel_saver/database.json

Configuration

Default settings (can be modified in saver.py):

• MESSAGES_BATCH_SIZE = 100 - Messages per batch
• BATCH_DELAY = 2 - Delay between batches (seconds)
• SAVE_INTERVAL = 300 - Database save interval (seconds)
• MAX_RETRIES = 3 - Maximum retry attempts

Error Handling

• Automatic retry on failed requests
• Session management and recovery
• Corrupted database detection
• Rate limit compliance

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Disclaimer

This tool is for educational purposes only. Make sure to comply with Telegram's Terms of Service and API usage guidelines when using this application.

Support

If you encounter any issues or have questions, please open an issue in the GitHub repository.

Troubleshooting

Common issues:

1. API Credentials Error: Make sure your .env file exists and contains valid API credentials
2. Database Errors: Check if the temp directory has proper write permissions
3. Rate Limiting: If you encounter frequent rate limits, try increasing BATCH_DELAY