{"id":13989218,"url":"https://github.com/aahnik/telewater","last_synced_at":"2025-07-22T10:31:32.673Z","repository":{"id":38219573,"uuid":"352998779","full_name":"aahnik/telewater","owner":"aahnik","description":"A telegram bot that applies watermark on images, gifs, and videos.","archived":true,"fork":false,"pushed_at":"2021-11-21T17:30:43.000Z","size":270,"stargazers_count":76,"open_issues_count":4,"forks_count":98,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-29T08:38:19.622Z","etag":null,"topics":["bot","deployment","digitalocean","ffmpeg","heroku","linux-vps","poetry","pypi-package","python","python-dotenv","python3","telegram","telegram-bot","telethon","ubuntu-server","watermark","watermark-gif","watermark-image","watermark-video","watermarking"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aahnik.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-03-30T12:48:30.000Z","updated_at":"2024-11-13T18:52:50.000Z","dependencies_parsed_at":"2022-09-10T11:42:48.902Z","dependency_job_id":null,"html_url":"https://github.com/aahnik/telewater","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/aahnik/telewater","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aahnik%2Ftelewater","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aahnik%2Ftelewater/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aahnik%2Ftelewater/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aahnik%2Ftelewater/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aahnik","download_url":"https://codeload.github.com/aahnik/telewater/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aahnik%2Ftelewater/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266475119,"owners_count":23934885,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","deployment","digitalocean","ffmpeg","heroku","linux-vps","poetry","pypi-package","python","python-dotenv","python3","telegram","telegram-bot","telethon","ubuntu-server","watermark","watermark-gif","watermark-image","watermark-video","watermarking"],"created_at":"2024-08-09T13:01:33.827Z","updated_at":"2025-07-22T10:31:32.366Z","avatar_url":"https://github.com/aahnik.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# telewater\n\nA telegram bot that applies watermark on images, gifs and videos.\n\n## Features\n\n- **Fast** because it is made using async libraries.\n- **Simple** to use.\n- 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 stored at a global level instead of per user basis.\n- **No database** connection required.\n- It **does not store media** (photos/videos/gifs) on the server. Media is deleted immediately after the watermarked version is sent to the user.\n\nWatch this [video on YouTube](https://www.youtube.com/watch?v=M-ouyCPdZw0) to learn how to use and deploy this bot.\n\n## Usage\n\nUsing the bot is very simple. Just send a photo, video or gif to the bot. The bot will reply with the watermarked media.\n\nThe bot commands `/set` and `/get` can set and get the value of the configuration variables. The commands are simple and intuitive. The bot will show you the usage if you send an incorrect argument.\n\n## Deploy\n\nClick on [this link](https://m.do.co/c/98b725055148) and get **free 100$**\non Digital Ocean.\n\n[![DigitalOcean Referral Badge](https://web-platforms.sfo2.digitaloceanspaces.com/WWW/Badge%203.svg)](https://www.digitalocean.com/?refcode=98b725055148\u0026utm_campaign=Referral_Invite\u0026utm_medium=Referral_Program\u0026utm_source=badge)\n\n\u003e **NOTE** You will get nothing if you directly sign up from Digital Ocean Home Page.\n\u003e **Use the link** above, or **click on the big fat button** above to get free 100$.\n\nRead the **[Guide to Deploy to Digital Ocean](https://github.com/aahnik/telewater/wiki/Deploy-to-Digital-Ocean)**.\n\n------\n\nThis application can also be easily deployed to Heroku, which is extremely good if you want to enjoy a free tier.\n\nYou may [read further](#further-reading) to learn about more more deployment options.\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/aahnik/telewater)\n\nClick on the above button. A form will appear, where you need to enter the credentials for the bot. After the app is deployed sucessfully, [turn on the woker dyno](https://user-images.githubusercontent.com/66209958/117938593-d6de0080-b324-11eb-9c0f-9bcc6d975808.png) to start the bot.\n\n## Installation\n\nThe following is the guide to install `telewater` on your computer, or VPS.\n\nIf you are a beginner, don't bother yourself with these. Just go ahead with the heroku method described abvoe.\n\nIf you are familiar with **Docker** then [click here](https://github.com/aahnik/telewater/wiki/Install-and-run-using-docker) otherwise, continue reading.\n\n#### Requirements\n\nMake sure to have these installed in your system.\n\n- [python3.9+](https://www.python.org/) and [pip](https://pip.pypa.io/en/stable/installing/) (the bot is built with the telethon library)\n- [ffmpeg](https://ffmpeg.org/) (used by the bot for applying watermark)\n\n#### Verification\n\nOpen you terminal to check if you have all basic requirements properly installed.\n\n1. Run `python --version` and you should get something like this `Python 3.9.2` (or above).\n2. Run `pip --version` and you should get `pip 20.2.2` (or above).\n\n    \u003e Some systems may require to use `python3` and `pip3` instead of the above.\n\n3. Run `ffmpeg -h` and it should display a help message and version above `4.2.4`.\n\n#### Install via pip\n\n```shell\npip install telewater\n```\n\n#### Starting `telewater`\n\nTelewater has a simple command line interface to start the bot.\n\nSimply open your terminal and run `telewater`. It will prompt you to enter the required information.\n\n## Further reading\n\n- [Environment Variables](https://github.com/aahnik/telewater/wiki/Environment-Variables)\n- [Telewater CLI usage](https://github.com/aahnik/telewater/wiki/Telewater-CLI-usage)\n- [Install and run using docker](https://github.com/aahnik/telewater/wiki/Install-and-run-using-docker)\n- [Deploy to Digital Ocean](https://github.com/aahnik/telewater/wiki/Deploy-to-Digital-Ocean)\n- [Run multiple instances](https://github.com/aahnik/telewater/wiki/Run-multiple-instances)\n\nFor any further help, feel free to [create an issue](https://github.com/aahnik/telewater/issues) in the GitHub repo.\n\n\u003c!-- AAHNIK 2021 --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faahnik%2Ftelewater","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faahnik%2Ftelewater","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faahnik%2Ftelewater/lists"}