Skip to main content

tgcli

PyPI PyPI PyPI PyPI Telegram Code Style

tgcli is a Python cli app for Telegram.

Build Coverage
Master Travis (.com) master
Development Travis (.com) development

Installing

Install via pip:

pip install tgcli

Rationale

A similar project, built on Python, was created by @vysheng, but it has not been updated since 2016 and considered abandoned. This tool is not a fork of the mentioned project, it is built from ground up.

Example

For now, the use case is pretty simple. To send a message:

tgcli bot --token "BotToken" send --receiver "UserID" message "Your message"

You don't need to expose your token as flag. If you set TELEGRAM_BOT_TOKEN environment variable, you do not need to set --token flag. Just set it before using tgcli:

export TELEGRAM_BOT_TOKEN="BotToken"

You can get more information by doing:

tgcli bot send --help

Also, this repository uses notification from a private bot, you can see the example Travis configuration here. Private TELEGRAM_BOT_TOKEN and TELEGRAM_RECEIVER environment variables were set.

This application serves a really small purpose for now. It might face breaking changes in the future.

Documentation

Documentation has an intensive amount of information about how to use tgcli. Refer to the documentation.

Donations

tgcli is a free (as in beer and speech) software that I have built in my leisure time and been maintaining it. If you like to use it, please consider a small donation.

How do I donate?

I accept donations in:

  • MiliBitcoin (mBTC)
  • Monero (XMR)

You can donate predefined (almost $1) or custom donation by clicking or scanning below.

Predefined (Almost $1) How Much You Wish
MiliBitcoin (mBTC) mBTC predefined mBTC custom
Monero (XMR) XMR predefined XMR custom

Release files for tgcli 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tgcli 0.3.1
File Size Uploaded
tgcli-0.3.1.tar.gz 8.7 kB Details

Release files / tgcli-0.3.1.tar.gz

Download URL tgcli-0.3.1.tar.gz
Size 8.7 kB
Tags Source
SHA-256 checksum
How to use checksums
217acf2badff3d9fafbf6bc8de69306d6dfdf08bdbaa7ccb39eeeb345cac3c73
BLAKE2b-256 checksum
How to use checksums
4db2d508e4a7f3d4ccd77cc070c908bc440dc1a9a1705e309e292fff0a412668
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.1
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page