Telegram extra features

At the time being there are few features not yet implemented on Telegram, neither on Premium subscription.

The goal of this repository is providing containerized module written in Python for having such features: you will need to run the container against your account on your host (e.g. NAS) or in the cloud (e.g. Azure, AWS, GCP).

Extra features

• No voice policy: automatically replies to any private voice message asking the effort to write a text message instead.
• Notify once fragmented text: auto snoozes subsequent messages from the same sender within a certain time window (e.g. 1 minute)

How to use

• Get API ID & hash, first time only
• Run the extra, as a container

Get API ID & hash

• Go to https://my.telegram.org
• API development tools
• Create a new Telegram Extras app to get api_id & api_hash

Run the extra

Here below few examples in real scenarios.

Locally

• Pull the extra image

  docker pull arisedream/telegram-extras-<extra-name>

• Run interactively for setting up your account

  docker run -i -t \
    --name telegram-extras-<extra-name> \
    -e TG_API_ID=<your-id> \
    -e TG_API_HASH=<your-hash> \
    -v /your/path/telegram-extras-<extra-name>.session:/telegram-extras-<extra-name>.session \
  telegram-extras-<extra-name>
  

• For running as a service

  docker run -d \
    --name telegram-extras-<extra-name> \
    --restart unless-stopped \
    -e TG_API_ID=<your-id> \
    -e TG_API_HASH=<your-hash> \
    -v /your/path/telegram-extras-<extra-name>.session:/telegram-extras-<extra-name>.session \
  telegram-extras-<extra-name>
  
  

NAS (Synology DSM 7)

• Run locally as described above to get session file telegram-extras-<extra-name>.session
• Create folder /volume1/docker/telegram-extras/<extra-name>
• Place the session file on the created folder
• Go to Container Manager app
• Create new image from arisedream/telegram-extras-<extra-name>
• Create new container telegram-extras-<extra-name>
  • Enable auto-restart
  • Environment:
    • TG_API_ID=<your-id>
    • TG_API_HASH=<your-hash>
  • Volume Settings:
    • /docker/telegram-extras/<extra-name>/telegram-extras-<extra-name>.session -> /telegram-extras-<extra-name>.session

Cloud

TBD

FAQ

Why don't you use bot?

Using bot we can't achieve the same result: it works in fact as long you are texting to it, or when including it on a group. Instead, when using API, we could react with some extra functionality, regardless the sender.

References

• Telethon: API Telegram client library for Python 3