Metadata-Version: 2.1
Name: telewater
Version: 0.0.6
Summary: A telegram bot that applies watermark on images, gifs and videos.
Home-page: https://github.com/aahnik/telewater
License: MIT
Keywords: telegram,watermark,bot,async
Author: aahnik
Author-email: daw@aahnik.dev
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Cython
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Software Development
Requires-Dist: Pillow (>=8.1.2,<9.0.0)
Requires-Dist: Telethon (>=1.21.1,<2.0.0)
Requires-Dist: aiohttp (>=3.7.4,<4.0.0)
Requires-Dist: cryptg (>=0.2.post2,<0.3)
Requires-Dist: hachoir (>=3.1.2,<4.0.0)
Requires-Dist: python-dotenv (>=0.16.0,<0.17.0)
Requires-Dist: requests (>=2.25.1,<3.0.0)
Requires-Dist: typer (>=0.3.2,<0.4.0)
Project-URL: Repository, https://github.com/aahnik/telewater
Description-Content-Type: text/markdown

# telewater

A telegram bot that applies watermark on images, gifs and videos.

## Features

- **Fast** because it is made using async libraries.
- **Simple** to use.
- Any one who uses an instance of the bot will have to use the same watermark and position. This is meant to be used by **single person/organization** (by only you or your team), as configuration is global.
- **No database** connection required.
- It **does not store media** (photos/videos/gifs) on the server. Media is deleted immediately after the watermarked version is sent to the user.


## Where to Deploy

- It is recommended to run this on a **Linux VPS**.
- [Heroku](https://www.heroku.com/) made me cry. Don't be seduced by "free" and "one-click" deploys.
- [Digital Ocean](https://www.digitalocean.com/) Ubuntu Droplet is a good choice for high performance.

## Installation

If you are familiar with `docker` then [click here](https://github.com/aahnik/telewater/wiki/Install-and-run-using-docker) otherwise, continue reading.

### Requirements

Make sure to have these installed in your system.

- [python3.9+](https://www.python.org/) and [pip](https://pip.pypa.io/en/stable/installing/) (the bot is built with the telethon library)
- [ffmpeg](https://ffmpeg.org/) (used by the bot for applying watermark)

### Verification

Open you terminal to check if you have all basic requirements properly installed.

1. Run `python --version` and you should get something like this `Python 3.9.2` (or above).
2. Run `pip --version` and you should get `pip 20.2.2` (or above).

    > Some systems may require to use `python3` and `pip3` instead of the above.

3. Run `ffmpeg -h` and it should display a help message and version above `4.2.4`.

### Install via pip

```shell
pip install telewater
```


## Usage

Telewater has a simple command line interface to start the bot.

Simply open your terminal and run `telewater`. It will prompt you to enter the required information.


## Furthur reading

- [Advanced CLI usage](https://github.com/aahnik/telewater/wiki/Telewater-CLI-usage)
- [Install and run using docker](https://github.com/aahnik/telewater/wiki/Install-and-run-using-docker)
- [Deploy to Digital Ocean](https://github.com/aahnik/telewater/wiki/Deploy-to-Digital-Ocean)
- [Run multiple instances](https://github.com/aahnik/telewater/wiki/Run-multiple-instances)


For any furthur help, feel free to [create an issue](https://github.com/aahnik/telewater/issues) in the github repo.


<!-- AAHNIK 2021 -->
