tg-index - GitLite

KO | EN

gitlite — search

#javascript #python #typescript #llm #go #machine-learning #macos #windows #awesome #kubernetes #awesome-list #security #mcp #ios

tg-index

(★ 430)

Python web app to index telegram chats and serve its files for download over HTTP.

File Explorer

Download Latest Version (.zip)

- - logout.png
  - sun.png
- - footer.html
  - header.html
  - home.html
  - index.html
  - info.html
  - login.html
  - otg.html
- - __init__.py
  - base.py
  - download.py
  - faviconicon_view.py
  - home_view.py
  - index_view.py
  - info_view.py
  - login_view.py
  - logo_view.py
  - logout_view.py
  - middlewhere.py
  - thumbnail_view.py
  - wildcard_view.py
- __main__.py
- config.py
- generate_session_string.py
- main.py
- routes.py
- telegram.py
- util.py
- .replit
- poetry.lock
- replit-deploy-guide.md
- run-dev.py
- run-repl.py
.gitignore
arial.ttf
LICENSE
README.md
requirements.txt

# Installation Guide

1. Get the code

git clone https://github.com/odysseusmax/tg-index

Downloads the entire project code from GitHub to your computer.

cd tg-index

Moves into the project folder you just downloaded.

2. Python

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

$ python -m venv venv

Runs the Python script (or module).

$ pip3 install -U -r requirements.txt

Installs the Python libraries listed in requirements.txt (or similar).

python3 -m app

Runs the Python script (or module).

✅ If it runs without errors and prints output in the terminal, it worked.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Telegram Index

> Python Web App which indexes a telegram channel(or a chat) and serves its files for download.

[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.png?v=103)](https://raw.githubusercontent.com/odysseusmax/tg-index/master/) [![GPLv3 license](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://raw.githubusercontent.com/odysseusmax/tg-index/master/LICENSE)

## Highlights

- Index one or more telegram channels/chats.
- View messages and media files on the browser.
- Search through the channel/chat.
- Download media files through browser/download managers.

## Deploy Guide

- **Clone to local machine.**

```bash
$ git clone https://github.com/odysseusmax/tg-index.git

$ cd tg-index
```

- **Create and activate virtual environment.**

```bash
$ python -m venv venv

$ source venv/bin/activate
```

- **Install dependencies.**

```bash
$ pip3 install -U -r requirements.txt
```

- **Environment Variables.**

| 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>.                                                                                                |
| `INDEX_SETTINGS` (required)          | See the below description.                                                                                                                                     |
| `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` (optional)                    | Port on which app should listen to, defaults to 8080.                                                                                                          |
| `HOST` (optional)                    | Host name on which app should listen to, defaults to 0.0.0.0.                                                                                                  |
| `DEBUG` (optional)                   | Give `true` to set logging level to debug, info by default.                                                                                                    |
| `BLOCK_DOWNLOADS` (optional)         | Enable downloads or not. If any value is provided, downloads will be disabled.                                                                                 |
| `RESULTS_PER_PAGE` (optional)        | Number of results to be returned per page defaults to 20.                                                                                                      |
| `TGINDEX_USERNAME` (optional)        | Username for authentication, defaults to `''`.                                                                                                                 |
| `PASSWORD` (optional)                | Password for authentication, defaults to `''`.                                                                                                                 |
| `SHORT_URL_LEN` (optional)           | Url length for aliases                                                                                                                                         |
| `SESSION_COOKIE_LIFETIME` (optional) | Number of minutes, for which authenticated session is valid for, after which user has to login again. defaults to 60.                                          |
| `SECRET_KEY` (optional)              | 32 characters long string for signing the session cookies, required if authentication is enabled.                                                              |

- **Setting value for `INDEX_SETTINGS`**

This is the general format, change the values of corresponding fields as your requirements. You can copy paste this as is to index all the channels available in your account.

**Remember to remove spaces.**

```json
{
  "index_all": true,
  "index_private": false,
  "index_group": false,
  "index_channel": true,
  "exclude_chats": [],
  "include_chats": []
}
```

> - `index_all` - Whether to consider all the chats associated with the telegram account. Value should either be `true` or `false`.
> - `index_private` - Whether to index private chats. Only considered if `index_all` is set to `true`. Value should either be `true` or `false`.
> - `index_group` - Whether to index group chats. Only considered if `index_all` is set to `true`. Value should either be `true` or `false`.
> - `index_channel` - Whether to index channels. Only considered if `index_all` is set to `true`. Value should either be `true` or `false`.
> - `exclude_chats` - An array/list of chat id's that should be ignored for indexing. Only considered if `index_all` is set to `true`.
> - `include_chats` - An array/list of chat id's to index. Only considered if `index_all` is set to `false`.

- **Run app.**

```bash
python3 -m app
```

## Deploy Guide (Repl.it)

A detailed and beginner friendly guide on how to deploy this project on a free instance of <https://repl.it> can be found [here](./repl-config/replit-deploy-guide.md).

## Contributions

Contributions are welcome.

## Contact

You can contact me [@odysseusmax](https://tx.me/odysseusmax).

## License

Code released under [The GNU General Public License](LICENSE).