TGF - Telegram Feed

Open-source Telegram content forwarding bot written in C

TGF monitors Telegram channels and automatically forwards new messages to a destination channel. Lightweight, single-binary, no bloat.

• Multi-source – Forward from many channels into one
• Reply chains – Forwards replies together with their parent messages
• Media albums – Groups album messages and forwards them as a batch
• Deduplication – Tracks forwarded messages so nothing is sent twice
• Configurable delay – Set a delay between forwards to avoid rate limits
• History window – Only forward messages from the last N hours
• Sequential forwarding – Collects all history first, then forwards messages in chronological order (asc/desc)
• Backfill resume – Persists scan state across restarts so no messages are missed
• Dashboard – Live terminal UI showing status (disable with -d)
• Single binary – TDLib is vendored; no system deps needed

• GCC or Clang
• A Telegram API ID and hash
• CMake & make (only if rebuilding TDLib from source)

git clone https://github.com/Hadi493/tgf-c.git
cd tgf-c

cp config.json.example config.json
# edit config.json with your API credentials and channels

gcc -o nob nob.c
./nob
./tgf

Edit config.json:

{
    "api_id": YOUR_API_ID,
    "api_hash": "YOUR_API_HASH",
    "source_channels": ["@channel1", "@channel2"],
    "dest_channel": "@me",
    "history_file": "history.txt",
    "forward_delay_sec": 10,
    "enable_sequential_forwarding": true,
    "sequence_direction": "asc",
    "history_window_hours": 24
}

./tgf         # normal mode – shows dashboard
./tgf -d      # debug mode – verbose logs, no dashboard

On first run you'll be prompted for your phone number, verification code, and 2FA password (if enabled). Session is cached in tdlib_db/.

GNU GPLv2

No strict guidelines – just follow the existing code style and keep it simple.