Telegram Gifts Radar

A Telegram userbot that monitors and notifies about new Telegram gifts in real-time.

Telegram Channel t.me/giftsradar

Features

• Monitors Telegram gifts every 30 seconds
• Posts notifications about new gifts
• Updates gift availability and stock status

Tech Stack

• TypeScript
• Bun Runtime
• Prisma ORM
• GramJS (Telegram client)
• Docker
• PostgreSQL

Prerequisites

• A Telegram API key (obtain here)
• PostgreSQL database

Configuration

1. Copy the .env.example file:

   cp .env.example .env

2. Fill in the environment variables in the .env file:

   TELEGRAM_SESSION_FILENAME=account
   TELEGRAM_API_ID=          # Your Telegram API ID
   TELEGRAM_API_HASH=        # Your Telegram API hash
   TELEGRAM_DEVICE_MODEL=    # e.g. "MacBook Air M1"
   TELEGRAM_SYSTEM_VERSION=  # e.g. "macOS 14.4.1" 
   TELEGRAM_APP_VERSION=     # e.g. "4.16.8 arm64"
   
   DATABASE_URL=             # PostgreSQL connection string
   CHAT_IDS=                 # Comma-separated list of Telegram chat IDs to notify in

Deployment

Using Docker (Recommended)

Make sure you have Docker installed

1. Build the Docker image:

   sh scripts/cd.sh

2. Run with integrated terminal to log into account, then Ctrl+C to stop

   sh scripts/run_integrated.sh

3. Run container in background (docker-compose)

   sh scripts/run.sh

Manual Instalation

Make sure you have Bun installed

1. Install dependencies

   bun install

2. Run database migrations and generate client

   bun run migrate
   bunx prisma generate

3. Start the application

   bun run start

License

MIT License

Author

Contact • My Telegram Channel