⎛⎝ ≽ > ⩊ < ≼ ⎠⎞
This Python script checks if a Telegram username is available or taken using the fragment website and the telegram web resource. No API key is required!
The script may currently produce false positives when identifying free usernames. This is due to Telegram’s reserved usernames, which are set aside for internal purposes. Additionally, there can be a delay before a username that has recently become available can be reused, so that username also may be marked as free but setting it is not available right now. I will fix it soon!
- Clone the repository and navigate into the directory:
git clone https://github.com/S4kur4H4run0/telegram-username-grabber.git
cd telegram-username-grabber
- Create a virtual environment:
python3.12 -m venv env
- Activate the virtual environment:
source env/bin/activate
- Install the required packages:
pip install -r requirements.txt
To run the script locally, use the following command:
python script.py --file https://raw.githubusercontent.com/path/to/usernames/list.txt --verbose
Replace script.py with the actual name of your Python script.
- The --file argument specifies the URL or path to the list of usernames.
- The --verbose flag enables detailed logging output.
To test the script in the GitHub Actions environment, create an issue using the Payload request template. In the issue body, provide a single URL and wait for approval to run the pipeline. 🥏
- Only files hosted on raw.githubusercontent.com are supported.
- Usernames must be listed one per line.
- For format reference, see this example file.
