Telegram Channel Word Counter

This script analyzes messages in a Telegram channel and counts word frequency. It uses the Telethon library to interact with the Telegram API.

Features

Count word frequency in a specified Telegram channel
Ability to specify the number of messages to analyze
Configurable minimum word length to ignore short words
Use of .env file for storing sensitive data

Requirements

Python 3.7+
Libraries: telethon, python-dotenv

Installation

Clone the repository:

git clone https://github.com/wakeoneself/telecount.git
cd telecount

Create a virtual environment and activate it:

python -m venv venv
source venv/bin/activate  # For Unix or MacOS
venv\Scripts\activate  # For Windows

Install the required dependencies:
```
pip install -r requirements.txt
```
Create a .env file in the root directory of the project and add your data:
```
API_ID=your_api_id
API_HASH=your_api_hash
PHONE_NUMBER=your_phone_number
```
You can obtain API_ID and API_HASH from https://my.telegram.org

Usage

Run the script by specifying the channel username (without the @ symbol), the number of messages to analyze, and optionally, the minimum word length:

python telecount.py channelname 1000 [--min-length MIN_LENGTH]

channelname: The username of the Telegram channel to analyze (without the @ symbol)
1000: The number of messages to analyze
--min-length: (Optional) The minimum length of words to consider. Default is 3 if not specified.

Examples:

Analyze 1000 messages, considering words of 3 or more characters (default):
```
python telecount.py channelname 1000
```
Analyze 500 messages, considering words of 4 or more characters:
```
python telecount.py channelname 500 --min-length 4
```

This will analyze the specified number of messages in the "channelname" channel and output the top 20 most frequently used words that meet the minimum length requirement.

Notes

You may need to go through the Telegram authentication process on the first run.
Results are output to the console as the top 20 most frequently used words.

Security

Never pass your API_ID, API_HASH, and phone number directly in the code.
Make sure the .env file is added to .gitignore to avoid accidentally publishing your sensitive data.

License

This project is distributed under the MIT license. See the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

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