Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/maxktz/telegram-gifts-radar
A Telegram userbot that monitors and notifies about new Telegram gifts in real-time.
https://github.com/maxktz/telegram-gifts-radar
gramjs pet-project postgres prisma telegram userbot
Last synced: 14 days ago
JSON representation
A Telegram userbot that monitors and notifies about new Telegram gifts in real-time.
- Host: GitHub
- URL: https://github.com/maxktz/telegram-gifts-radar
- Owner: maxktz
- License: mit
- Created: 2025-01-09T02:31:33.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-01-25T22:45:15.000Z (21 days ago)
- Last Synced: 2025-01-25T23:31:58.071Z (21 days ago)
- Topics: gramjs, pet-project, postgres, prisma, telegram, userbot
- Language: TypeScript
- Homepage: https://t.me/giftsradar
- Size: 237 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Telegram Gifts Radar
__A Telegram userbot that monitors and notifies about new Telegram gifts in real-time.__
> __Telegram Channel [t.me/giftsradar](https:/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](https://my.telegram.org/apps))
- PostgreSQL database
## Configuration
1. Copy the `.env.example` file:
```sh
cp .env.example .env
```
2. Fill in the environment variables in the `.env` file:
```sh
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](https://https://docker.io/) installed
1. Build the Docker image:
```sh
sh scripts/cd.sh
```
2. Run with integrated terminal to log into account, then Ctrl+C to stop
```sh
sh scripts/run_integrated.sh
```
3. Run container in background _(docker-compose)_
```sh
sh scripts/run.sh
```
### Manual Instalation
> Make sure you have [Bun](https://bun.sh) installed
1. Install dependencies
```sh
bun install
```
2. Run database migrations and generate client
```sh
bun run migrate
bunx prisma generate
```
3. Start the application
```sh
bun run start
```
## License
[MIT License](LICENSE)
## Author
[Contact](t.me/maxktz) • [My Telegram Channel](t.me/xcrypto_dev)