TG Gifts Notifier

Overview

TG Gifts Notifier is a tool designed to notify users about new gifts available on the Telegram platform. It helps users stay updated and never miss out on any gifts.

My game's Telegram channel — Forgotten Memories (This game is my personal project, so I am advertising it.) Thanks for Subscribe!

Features

Note: This project requires Python 3.10 or higher to run.

• Real-time notifications
• Easy setup and configuration
• Customizable notification settings

Installation

To install TG Gifts Notifier, follow these steps:

1. Clone the repository:

   git clone https://github.com/arynyklas/tg_gifts_notifier.git

2. Navigate to the project directory:

   cd tg_gifts_notifier

3. Install the required dependencies:

   pip install -r requirements.txt

Usage

To start the notifier, run:

python detector.py

If you want to just fetch the gifts data with removing current data, use the --save-only/-S flag:

python detector.py --save-only

Configuration

At first rename config.example.py to config.py.

Then, you must configure the notifier by editing the config.py file.

Field	Type	Description
SESSION_NAME	String	Name of the session file where the userbot's session will be stored
API_ID	Integer	Your Telegram API ID obtained from my.telegram.org
API_HASH	String	Your Telegram API Hash corresponding to your API ID
BOT_TOKENS	[String]	Bot tokens provided by BotFather of your Telegram bot to send and edit messages
CHECK_INTERVAL	Float	Time interval (in seconds) between checks for new gifts
CHECK_UPGRADES_PER_CYCLE	Float	Time interval (in seconds) to check upgradability of gifts per cycle
DATA_FILEPATH	String	Path to the file where the gift data is stored
DATA_SAVER_DELAY	Float	Delay (in seconds) to save data to the file
NOTIFY_CHAT_ID	Integer	Chat ID where new gifts' messages will be sent
NOTIFY_UPGRADES_CHAT_ID	Integer or None	Chat ID where gifts' upgradability messages will be sent
NOTIFY_AFTER_STICKER_DELAY	Float	Delay (in seconds) after sending a sticker before sending a message
NOTIFY_AFTER_TEXT_DELAY	Float	Delay (in seconds) after sending a message
TIMEZONE	String	Timezone for the messages' date & time (e.g., "Europe/Moscow")
HTTP_REQUEST_TIMEOUT	Float	Timeout for Bot API requests (in seconds)

Helping with the code

If you want to add a new feature, create a pull request with a detailed description of this feature.

---

Thank you for your support!