AlarmBot

A telegram bot that serves as an alarm clock, runs best on a RaspberryPi

Requirements

• Python3 (and pip probably)
• python-telegram-bot (7.0.1+)
• pyaudio
• pulseaudio (or anything pyaudio compatible)
• pydub
• python-crontab
• cron-descriptor
• croniter
• emoji

How does it look?

Here is a blog post about this, with even more install and usage instructions.

How to use it?

1. Install the requirements, in ubuntu:

   sudo ./src/install_deps.sh
   

or:

sudo apt-get install -y python3-pip ffmpeg libavcodec-extra python3-pyaudio pulseaudio
sudo pip3 install -r src/requirements.txt

2. Set copy config.ini.example to config ini and add there your bot's token. You can get a bot token by sending /newbot to @BotFather

3. Run:

   src/alarm_bot.py
   

4. Message /start to your bot to set up alarms.

Set up service on startup

Run src/add_startup_service.sh either as the user you want the service to be run as, or src/add_startup_service.sh <user to run script>

Attribution

alarm.mp3 is by TheZero under CC 1.0

Code contributions are loved!