Skip to content

Projects using Telethon

Shrimadhav U K edited this page May 5, 2021 · 18 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 on 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 which 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.


A tool to download Telegram data (users, chats, messages, and media) into a database (and display the saved data). Due to Telegram's constant changes and lack of interest to continue development, the repository is now archived.

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 to connect multiple social Media accounts including Telegram, Discord and Twitter at 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.