Skip to content

A Python tool for checking Telegram accounts via phone numbers or usernames. Automatically verifies account existence, downloads profile pictures, and provides detailed user information in a clean JSON format. Built with Telethon API for reliable Telegram interaction.

License

Notifications You must be signed in to change notification settings

unnohwn/telegram-checker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📱 Telegram Account Checker

Enhanced version of bellingcat's Telegram Phone Checker!

A Python script to check Telegram accounts using phone numbers or username.

✨ Features

  • 🔍 Check single or multiple phone numbers and usernames
  • 📁 Import numbers from text file
  • 📸 Auto-download profile pictures
  • 💾 Save results as JSON
  • 🔐 Secure credential storage
  • 📊 Detailed user information

🚀 Installation

  1. Clone the repository:
git clone https://github.com/unnohwn/telegram-checker.git
cd telegram-checker
  1. Install required packages:
pip install -r requirements.txt

📦 Requirements

Contents of requirements.txt:

telethon
rich
click
python-dotenv

Or install packages individually:

pip install telethon rich click python-dotenv

⚙️ Configuration

First time running the script, you'll need:

  • Telegram API credentials (get from https://my.telegram.org/apps)
  • Your Telegram phone number including countrycode +
  • Verification code (sent to your Telegram)

💻 Usage

Run the script:

python telegram_checker.py

Choose from options:

  1. Check phone numbers from input
  2. Check phone numbers from file
  3. Check usernames from input
  4. Check usernames from file
  5. Clear saved credentials
  6. Exit

📂 Output

Results are saved in:

  • results/ - JSON files with detailed information
  • profile_photos/ - Downloaded profile pictures

⚠️ Note

This tool is for educational purposes only. Please respect Telegram's terms of service and user privacy.

📄 License

MIT License

About

A Python tool for checking Telegram accounts via phone numbers or usernames. Automatically verifies account existence, downloads profile pictures, and provides detailed user information in a clean JSON format. Built with Telethon API for reliable Telegram interaction.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published

Languages