birth-tg-bot's Introduction

Telegram bot to remind birthdays

This is a simple telegram bot that send message when is someone birthday.

Requirements

You need to create your own telegram bot [guide here] and know your chat ID [use @userinfobot].

Install

Clone the repo

git clone https://github.com/its-fonsy/birth-tg-bot.git

cd into it and install the requirements

cd birth-tg-bot
pip install -r requirements.txt

create the files to store the token of your bot, the chat_id of your profile and the database with all the birthdays

touch token chat_id bday.dat

fill for each file the required information then start the bot

python3 birth-tg-bot.py

Database

The database has this format

May 5 Henry Cavill
June 1 Tom Holland
June 9 Natalie Portman
August 15 Jennifer Lawrence
September 2 Keanu Reeves

You can use the bday.template file to start adding your birthdays.

Usage

Once the bot is running you can send with telegram this command to the bot:

\list to list all the birthday of your database
\add to add a birthday to your database
\next to see the four next coming birthday
\update to sync the list of the database with the list of the bot

BotFather

The message that I use with Botfather to \setcommands

start - the bot say hi
list - list all the birthday of your database
add - add a birthday to your database
next - see the four next coming birthday
update - sync the list of the database with the list of the bot
cancel - cancel the operation when adding a person

Recommend Projects