Skip to content

Projects using Telethon

Lonami edited this page Jul 6, 2023 · 17 revisions

This page lists some real-world examples showcasing what can be built with the library.

Some are more interesting or useful than others, but it should give you a bit of an idea of what can be built with the library and perhaps draw inspiration from them.

Please do not change the order of the list! You can add your project to the bottom (and obviously don't modify other people's projects, unless you are fixing a typo). If a maintainer of the Telethon project finds your contribution more outstanding than the rest, it will be moved up.


The documentation is not the only place where you can find useful code snippets using the library. The main repository also has a folder with some cool examples (even a Tkinter GUI!) which you can download, edit and run to learn and play with them.

You can find useful short snippets for Telethon here.

This add-on can be used to work with secret chats in Telethon!


A Matrix-Telegram hybrid puppeting/relaybot bridge.

A Telegram client on your terminal.

Pomegranate (or garnet for short) is a small telethon add-on that features persistent conversations based on Finite State Machines (FSM), a new Filter to define handlers more conveniently and utilities to run code on start and finish of the client. Be sure to check the project to learn about its latest features, since this description may be out of date.

Opensource Telegram-based cloud storage.

Mount Telegram dialogs and channels as a Virtual File System.

A tool for exporting Telegram group chats into static websites, preserving chat history like mailing list archives.

Telegram-upload uses your personal Telegram account to upload and download files up to 4 GiB (2 GiB for free users). This project improves the upload speed of Telethon by uploading chunks in parallel. A benchmark with the upload speed is available. Telegram-upload is widely tested and has been in development since 2018. The project has multiple features like interactive mode, video thumbs, split & join large files, advanced formatting for caption messages and more.


A Telegram bot, to check what restrictions bots, groups, or channels have. It also works with Private Channel Link and Telegram Regional Restrictions.

A Terminal Bot, inside Telegram to execute GNU/Linux / evaluate Python commands.

ConfluxBot allows connecting multiple social Media accounts including Telegram, Discord, and Twitter in one place. Users can create cross-posts between accounts and also forward messages between them by creating connections.

Sync your Telegram profile photo and name with songs playing on Spotify/LastFM.

Search Videos / Audio / Documents / GiF using InLine mode of a specific chat, without using any database.

The ultimate tool to automate custom telegram message forwarding. It supports two modes of operation: past or live for dealing with either existing or upcoming messages. Supports filtering of messages based on whitelists and blacklists of text, user, and file type. With tgcf you can also do custom text replacement. One-click deploys to Heroku, Digital Ocean, Gitpod, and GitHub Actions(scheduled workflow to run tgcf in past mode).

The Pluggable Telethon UserBot, made from scratch, which is aimed to increase security with addition of many other useful features.

A bot that converts e-books to various formats, powered by calibre! Currently, it supports 34 input formats and 19 output formats.

Deltachat Telegram bridge is an email based telegram bridge using Telethon and simplebot to communicate with telegram chats using the email.

Telminal is a Python package that helps you have your own server assistant Telegram bot. You can use Telminal as a terminal or to download & upload files.

A graphical flow editor storytelling engine. Connect External Software and Hardware with the Telegram Mesenger to create Games and Stories for Theater and Live Games, Escape Rooms, Scavenger Hunts and so forth.

TGPy instantly runs Python code in your messages, as that was written in the Python shell. You can use any Python or Telethon features in your chats to run expressions, automate sending messages, and integrate other services. Docs