tgcf 0.1.15

The ultimate tool to automate telegram message forwarding.

tgcf

The ultimate tool to automate telegram message forwarding.

The key features are:

1. Two modes of operation are past or live for dealing with either existing or upcoming messages.
2. Supports signing in with both telegram bot account as well as user account.
3. Custom Filtering of messages based on whitelist or blacklist.
4. Modification of messages like Text Replacement, Watermarking, OCR etc.
5. Detailed documentation📖 + Video tutorial + Fast help in discussion forum💬.
6. If you are a python developer, writing plugins🔌 is like stealing candy from a baby.

What are you waiting for? Star 🌟 the repo and click Watch 🕵 to recieve updates.

You can also join the official Telegram Channel, to recieve updates without any ads.

Video Tutorial 📺

A youtube video is coming soon. Subscribe to get notified.

Run Locally 🔥

Note: Make sure you have Python 3.8 or above installed. Go to python.org to download python.

Platform	Supported
Windows	✅
Mac	✅
Linux	✅
Android	✅

If you are familiar with Docker, you may go that way for an easier life.

Open your terminal (command prompt) and run the following commands.

pip install pipx
pipx install tgcf

To check if the installation succeeded, run

tgcf --version

If you see an error, that means installation failed.

Configuration ⚙️

Configuring tgcf is easy. You just need two files.

• .env : You heard it right! Just .env. This file is for storing your secret credentials for signing into Telegram. This file is for defining the environment variables. You can do so by other methods also.

• tgcf.config.yml : An yaml file to configure how tgcf behaves.

Run on cloud 🌩️

Deploying to a cloud server is an easier alternative if you cannot install on your own machine. Cloud servers are very reliable and great for running tgcf in live mode.

When you are deploying on a cloud platform, you can configure tgcf using environment variables. The contents of tgcf.config.yml can be put inside the environment variable called TGCF_CONFIG.

How to ?

If you need to run tgcf in past mode periodically, then you can use GitHub Actions to run a scheduled workflow.

Getting Help 💁🏻

• First of all read the wiki and [watch the videos.
• If you still have doubts, you can try searching your problem in discussion forum or the issue tracker.
• Feel free to ask your questions in the Discussion forum.
• For reporting bugs or requesting a feature please use the issue tracker for this repo.

Please do not send me direct messages in Telegram. (Exception: Sponsors can message me anytime)