
Python Web App which indexes a telegram channel(or a chat) and serves its files for download.
Overview
- This app indexes all the available messages.
- If the message is a media message, you can download the file.
- You can search for specific terms too.
Demo
https://telegram-index.herokuapp.com
https://ricky-adarsh.herokuapp.com
📸 Screenshots



📥 Project Repository
https://github.com/odysseusmax/tg-index
Deploy Guide
git clone https://github.com/odysseusmax/tg-index.git
cd tg-index
- Create and activate virtual environment.
pip3 install virtualenv
virtualenv venv
source venv/bin/activate
pip3 install -U -r requirements.txt
Variable Name | Value |
API_ID (required) | Telegram api_id obtained from https://my.telegram.org/apps. |
API_HASH (required) | Telegram api_hash obtained from https://my.telegram.org/apps. |
CHAT_ID (required) | Id of the telegram channel (or chat) to be indexed. Separate id’s with space if you want to index more than one channel. |
SESSION_STRING (required) | String obtained by running $ python3 app/generate_session_string.py . (Login with the telegram account which is a participant of the given channel (or chat). |
PORT (opt) | Port on which app should listen to, defaults to 8080. |
HOST (opt) | Host name on which app should listen to, defaults to 0.0.0.0. |
DEBUG (opt) | Give some value to set logging level to debug, info by default. |
To obtain the CHAT_ID
of a channel, forward a message from that channel to @ShowJsonBot

python3 -m app
Deploy on other Platforms



Video Tutorial
Here’s a YouTube tutorial video for deploying to Heroku. Video Link