Skip to main content

The ultimate tool to automate custom telegram message forwarding.

Project description

tgcf logo

tgcf

The ultimate tool to automate custom telegram message forwarding.

GitHub license GitHub stars GitHub issues PyPI Twitter

Code Quality

Live-syncer, Auto-poster, backup-bot, cloner, chat-forwarder, duplicator, ...

Call it whatever you like! tgcf can fulfill your custom needs.

Videos

The following videos (english) explain everything in great detail.

  • Feature Overview
  • Running on Windows/Mac/Linux
  • Running on Android
  • Deploy to Digital Ocean Droplet
  • Running on Gitpod

Supported environments

  • Linux
  • Mac
  • Windows (Running Ubuntu on top of WSL-2)
  • Android (Using Termux app)
  • Any Linux VPS

Install and Run

If you want to use tgcf for free, then run on your own desktop or mobile computer.

Make sure you are on a supported environment and have python:3.10 or above, installed.

  • Create a directory and move into it.

    mkdir my-tgcf
    cd my-tgcf
    
  • Create a python virtual environment and activate it.

    python3 -m venv .venv
    source .venv/bin/activate
    
  • Install tgcf using pip

    pip install tgcf
    tgcf --version
    
  • Set the password for accessing web interface.

    echo "PASSWORD=mypass" >> .env
    

    Set your own password, instead of "mypass". The password is to be set in the .env file.

  • Start the web-server.

    tgcf-web
    

To run tgcf without the web-ui read about tgcf cli.

Deploy to Cloud

Click on this link and get free 200$ on Digital Ocean.

DigitalOcean Referral Badge

NOTE You will get nothing if you directly sign up from Digital Ocean Home Page. Use the link above, or click on the big fat button above to get free 200$.

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 for a long time.

You can enjoy smooth one-click deploys to the major cloud providers.

Getting Help

  • First of all read the wiki and watch the videos to get started.

  • Type your question in GitHub's Search bar on the top left of this page, and click "In this repository". Go through the issues, discussions and wiki pages that appear in the result. Try re-wording your query a few times before you give up.

  • If your question does not already exist, feel free to ask your questions in the Discussion forum. Please avoid duplicates.

  • For reporting bugs or requesting a new feature please use the issue tracker of the repo.

Contributing

PRs are most welcome! Read the contributing guidelines to get started.

If you are not a developer, you may also contribute financially to incentivise the development of any custom feature you need.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tgcf-0.5.tar.gz (23.9 kB view details)

Uploaded Source

Built Distribution

tgcf-0.5-py3-none-any.whl (29.1 kB view details)

Uploaded Python 3

File details

Details for the file tgcf-0.5.tar.gz.

File metadata

  • Download URL: tgcf-0.5.tar.gz
  • Upload date:
  • Size: 23.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.2.1 CPython/3.10.4 Linux/5.15.68.1-microsoft-standard-WSL2

File hashes

Hashes for tgcf-0.5.tar.gz
Algorithm Hash digest
SHA256 5d5fdab73b4b7145a81079903efee102b73ad1bb65b5eeed45b0bdfc5be8fa94
MD5 e1f2d0049be0a86a0ae63918c2170827
BLAKE2b-256 26c4e3abf8e28c92317c3630121490ab9aa7aae2b61b00be1565c30bfad4ad6e

See more details on using hashes here.

File details

Details for the file tgcf-0.5-py3-none-any.whl.

File metadata

  • Download URL: tgcf-0.5-py3-none-any.whl
  • Upload date:
  • Size: 29.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.2.1 CPython/3.10.4 Linux/5.15.68.1-microsoft-standard-WSL2

File hashes

Hashes for tgcf-0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 270ba893660fe3ff5158471d7a8af62ea541babca3c23c0954b01e198eb3abd3
MD5 862de64a23284ef7942a5a1572317376
BLAKE2b-256 439dc176e05764294e3f96bebe500c04815880af5dfe0d652bd0e024d467a37b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page