🎁 Telegram Gifts Parser

[]

Search for users with non-upgraded limited gifts in chats.

English | Русский

📱 Screenshots

Click to expand

Main

Result

✨ Features

• 🔍 Automatic Telegram chat scanning
• ✨ Detection of limited, non-upgraded gifts (NFT)
• 📊 Collection of user profiles and gift IDs
• 💾 Saving scan results
• 🔄 Batch processing of multiple chat links
• 🌐 Multilingual interface (English and Russian)
• 🔄 Automatic cache updating for gift names

🛠 Installation

1. Clone the repository: (or just download it)

   git clone https://github.com/bohd4nx/gifts-parser.git
   cd gifts-parser

2. Install dependencies:

   pip install -r requirements.txt

3. Edit config.ini in the project root directory:

   • Set your Bot Token
   • Set your Telegram API ID and API Hash
   • Add your phone number in international format
   • Configure admins and parsing parameters

🚀 Usage

1. Start the bot:

   python main.py

2. Send the bot a /start command and follow the instructions:
   • Provide a Telegram chat link (e.g., https://t.me/somechat)
   • For batch processing, send multiple links separated by new lines
   • Wait for the bot to parse the chat(s)
   • Use the download button to get results

🔧 Example Usage & Output

1. Send the '/start' command to the bot.

2. The bot will ask for a Telegram chat link or multiple links:

   https://t.me/samplechat
   https://t.me/anotherchat
   

3. Bot starts parsing each chat sequentially and shows progress:

   🔍 Parsing chat [1/3]: @samplechat
   📊 Total members: 15K
   👤 Processed: 10K/15K
   ✨ Users found: 9.1K
   ⌛ Estimated time remaining: 1h 33m
   

4. After finishing all chats, the bot offers downloads for each result.

📝 License

This project is MIT licensed. See LICENSE for more information.

🌟 Support

If you find this project useful:

• Give it a star ⭐
• Share with others 🔄
• Consider contributing 🛠️

---

Built with ❤️ by Bohdan