A simple Telegram bot that sends notifications and reminders at specific times or after a set duration. This bot is ideal for anyone who wants to use Telegram as a centralized platform for reminders and timed notifications.
This bot was created to help users receive scheduled messages directly within Telegram. Telegram’s cross-device functionality allows users to access these notifications on any device, ensuring messages remain visible as unread until checked.
This project is a Minimum Viable Product (MVP), with basic functionalities. New features and enhancements will be added in future iterations.
- Notifications at Specific Times: Schedule a notification message to be sent at an exact time or date.
- Timer: Set a countdown timer that sends a message after the specified duration.
- Time Zone Support: Set your timezone using IANA format to receive accurate local-time notifications.
Telegram Bot Token: You’ll need a token from BotFather to run the bot.
- Clone the repository
git clone https://github.com/yourusername/your-repo-name.git
cd your-repo-name- Install dependencies
pip install -r requirements.txt- Configure environment variables
TELEGRAM_BOT_TOKEN=<your-telegram-bot-token>
DB_PATH=data/users.db # optional- Run the bot
python main.py- /settimezone: Set the timezone to receive notifications in your local time. Use IANA timezone format, e.g., Asia/Tbilisi.
- /timer: Set a countdown timer that will send a message after a specified time.
- /reminder: Schedule a message to be sent at a specific time and date. Note: /settimezone must be used before setting reminders for accurate scheduling.