Telegram Timer bot with PyTelegramBotAPI

This bot will help you set a timer on a device and have all your devices using Telegram notify you when the timer ends.

Environment variables

• TG_API - Telegram Bot API which controls messaging (required)

• URL - URL if you want to open a url when timer runs out (optional)

  • Default: https://www.jucktion.com

• TIMER - Timer duration for the timer (optional)

  • Default: 3600

• DEBUG - Debug the application (0 or 1) (optional)

  • Default: 0 (False)

Local Deployment

• Create a virtual environment for your bot
• Install dependencies with pip install -r requirements.txt
• Run the bot with python main.py

For local deployment or testing you can set environment variable on your OS or in an env.py file.

Setup

To set this up you will need

• Telegram bot API from BotFather
• A heroku account for deployment
• Deploy using the deploy button below
• Setup environment variables mentioned above in your app settings
• Start chat with the bot

Commands

• /go - Display the timer controls
• /set - Set the timer (in seconds)
• /link - Set a valid url
• /check - Check the remaining/elasped time

Deploy

Screenshots

Start screen

Change the timer duration

Check remaining time

Open Link

License

GNU/GPL Version 3