A pragmatic, highly customizable, and reliable tool for forwarding Telegram messages.
Note: Maintained by YuanSheng Chiu (@yschiu11). This is a continuation of the original project by Aahnik Daw, engineered to keep it alive and functional.
At its core, tgcf is a message pipeline. It takes messages from a source and pipes them to a destination.
It operates in two modes:
- Live: Listens for new messages and forwards them in real-time.
- Past: Dumps existing message history from designated chats.
It works with both standard User accounts and Bot accounts.
Most forwarding tools are bloated, paid, or abandoned. tgcf provides a clean architecture built around plugins. It intercepts messages, mutates them based on rules, and forwards them.
- Filters: Whitelist or blacklist messages based on logic, not guesses.
- Mutators: Regex search and replace, strip formatting, or append metadata (headers/footers).
- Media Processing: Apply watermarks to images and videos, or run OCR to extract text.
There is no cloud lock-in. You run it on your own hardware, manage your own config via JSON, or use the provided Web UI.
You need Python 3.10 or newer. A virtual environment is strictly recommended.
git clone https://github.com/yschiu11/tgcf.git tgcf-server
cd tgcf-server
python3 -m venv .venv
source .venv/bin/activate
# Install the package locally
pip install .
# Set a secure password for the web interface
echo "PASSWORD=your_secure_password" >> .env
# Start the daemon
tgcf-webNow open your browser, log in, configure your pipelines, and let it run.
- Documentation: Read the Docs
- Visual Guides: Video Tutorials
If the software fails or you encounter legitimate bugs, report them on the Issue Tracker.
Keep it simple. Write clean plugins. Don't submit unreadable code.
MIT License. Copyright (c) 2025 YuanSheng Chiu Copyright (c) 2020 Aahnik Daw