TBot - Telegram Userbot CLI

A lightweight, single-account Telegram userbot CLI written in Go.

Features

• 🚀 Broadcast System: Send messages to all joined groups with spintax support
• 🔍 Group Joiner: Search and join groups by keyword with smart filtering
• 👤 Account Status: Check SpamBot status and total joined groups
• 🎨 Beautiful UI: Colorful, emoji-rich terminal interface
• ⚡ Optimized: Proper pagination (no 100 group limit), rate limit handling

Quick Start

1. Setup Credentials

   copy .env.example .env
   # Edit .env with your API credentials from https://my.telegram.org/apps

2. Create Message Template

   Edit message.txt with your broadcast message
   Supports spintax: {Hello|Hi} {friend|buddy}!
   

3. Add Promo Image (Optional)

   Place promo.jpg, promo.png, or promo.gif in the same folder
   

4. Run

   # Development
   go run ./cmd/tbot
   
   # Build executable
   go build -o tbot.exe ./cmd/tbot
   ./tbot.exe

Configuration

Required (.env)

Variable	Description
APP_ID	Telegram API ID from my.telegram.org
APP_HASH	Telegram API Hash from my.telegram.org
PHONE	Your phone number with country code

Optional (.env)

Variable	Default	Description
BROADCAST_DELAY_MIN	5	Minimum delay between messages (seconds)
BROADCAST_DELAY_MAX	15	Maximum delay between messages (seconds)
JOIN_DELAY_MIN	30	Minimum delay between joins (seconds)
JOIN_DELAY_MAX	60	Maximum delay between joins (seconds)

Spintax

Use {option1|option2|option3} syntax in message.txt:

{Hello|Hi|Hey} {friend|buddy|mate}!
Check out our {amazing|awesome|cool} {product|service}.

Each message will randomly pick one option from each group.

Files

File	Purpose
.env	API credentials and settings
message.txt	Broadcast message template
promo.*	Image attachment (jpg/png/gif)
session.json	Login session (auto-created)

Safety Tips

1. Use reasonable delays - Default 5-15s for broadcast, 30-60s for joins
2. Don't spam - Use for legitimate purposes only
3. Monitor SpamBot - Check account status regularly
4. Use spintax - Helps avoid spam detection

Build

# Windows
go build -o tbot.exe ./cmd/tbot

# Linux/Mac
go build -o tbot ./cmd/tbot

License

MIT