Sometimes in some point of life, you may think that a lot of messages, a lot of times are just repeating. From Hii, How are you, What's up ? to Thank you, Good night. Yes these are small, but there are also other huge messages that we have to sit and type every time!
Stop repeating yourself! Just Do Not Repeat Yourself.
DoNotRepeatBot is a Telegram bot that saves messages for you, so you can send them in any chat with just a few key presses. All your snippets are stored in the bot's database and can be accessed and updated easily.
Open DoNotRepeatBot in Telegram and send it a /guide command.
Documentation about the commands, usage etc. is available under /help command.
The bot's source code is under GPL v3 license. Feel free to fork the repository and make changes as you wish. If you have any improvements, bug reports, feature requests, please open a new issue or ask in DoNotRepeatBot Group.
The translation related files are located under /locales. Familiarity with GNU gettext will help you a lot. Please add or improve existing translation and create a pull request.
Hosting the bot yourself is dead easy. Have some patience and a good internet connection.
The following applications / modules are important for running the bot.
- Python Python is the programming language in which the bot is written.
- Python Telegram Bot This package is necessary to interact with Telegram.
- PostgreSQL PostgreSQL is a relational database management system. It is used to store snippets.
- psycopg This package allows connecting to database using Python.
All the above requirements are free and open-source. You can download and install them for free.
Next step is downloading a copy of the bot. This can be done by cloning the repository (via git) or Github website's features.
After downloading, move the directory to a convenient location.
After installing database, you need to set up tables. Open a Terminal or Console in the bot's directory and enter the following command.
$ psql -f data/schema.sql
Go to BotFather and get a bot token. Following this, make your database URL. Then, export the values as your environment variables. For example in a UNIX shell, you can do.
$ export TOKEN="<TOKEN>"
$ export DATABASE_URL="<DATABASE URL>"Congrats, now you are on the final steps! Based on the capabilities of your server (the computer), you can use the following ways. Depending on the environment variables, the bot automatically uses polling or webhooks.
Polling asks Telegram server periodically for updates and handles them. To start the bot in polling method, open a Terminal or Console in the bot's directory and execute the following command.
$ python3 -m DoNotRepeatBotHere python3 is name of Python interpreter in your system. Based on your operating system, it can be py3, python or something else.
If you had changed the directory names, that is if you are using some other name instead of DoNotRepeatBot, use that name.
You can changed the polling interval using INTERVAL (should be an integer) environment variable.
Webhooks work on a different method. Here Telegram sends you updates as they are received. Setting up webhooks can be irritating but they worth the pain. Before diving deep, read the following articles. They can clear most of the doubts and how-tos.
After reading the above, export the following environment variables.
LISTEN- The URL on which the bot listens.URL_PATH- The URL to which Telegram sends updates.PORT- The port on which the bot listens.WEBHOOK_URL- The public URL to your server.
Note that 1, 2 and 4 are URLs and don't append any extra slash at the end of URL. That is, your link should be https://www.example.com and not https://www.example.com/.
The value of port should be an integer.
Now start your bot with the following command, as did in polling.
$ python3 -m DoNotRepeatBot
Everything should work fine now! Check it and if you have any doubt, please ask in DoNotRepeatBot Group.