Metadata-Version: 2.1
Name: telegram-bell
Version: 0.6.2
Summary: Notify you when something is mentioned in a telegram channel
License: MIT
Author: Pablo Cabezas
Author-email: headsrooms@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Requires-Dist: 12factor-configclasses (>=1.0.0,<2.0.0)
Requires-Dist: anyio (>=3.3.4,<4.0.0)
Requires-Dist: asyncclick (>=8.0.1,<9.0.0)
Requires-Dist: python-dotenv (>=0.19.1,<0.20.0)
Requires-Dist: rich (>=10.12.0,<11.0.0)
Requires-Dist: telethon (>=1.23,<2.0)
Description-Content-Type: text/markdown

# telegram-bell

![PyPI](https://img.shields.io/pypi/v/telegram-bell)

Notify you when something is mentioned in a telegram channel.

## Install

    pip install telegram-bell

## Usage

### CLI

#### Run

    tbell run

Before you can use, it will ask you for:

- your Telegram API ID
- your Telegram API hash
- channels and keywords which you want to get notified
- Telegram token (2FA)

Then, the app will resend you the coinciding messages to your 'Saved Messages' channel in Telegram.

#### Config

    tbell config

#### Show susbscribed channels

    tbell show

### Systemd user service

Clone the repo and:

    cd telegram-bell/scripts
    sh install_service.sh
    sh start_service.sh # it will ask you for config

Check the service is running:

    sh check_service.sh

You can check the services logs too:

    sh show_service_logs.sh

If the service fails or the machine is restarted, the service will run transparently again.

If you want to change your config in some moment:

    tbell config
    sh restart_service.sh
