Home security system with Raspberry Pi and sending notifications with a Telegram bot

Tutorial to build a home security system with Raspberry Pi and sending notifications with a Telegram bot.

How it works

• When a movement is detected, the application records a video that is sent to your phone by the Telegram bot.
• Once installed, the surveillance system is managed from your smartphone with bot commands from the Telegram app.
• The system is started by a systemd service activated at boot time

Prerequisites.

• Raspberry Pi Camera Module
• PIR motion sensor module
• 3 female-to-female jumper wires
• Tutorial for create your Telegram Bot
• After starting the bot on your smartphone, you must retrieve your chat_id at the following address:
  • https://api.telegram.org/bot<token_id>/getUpdates

Connect the PIR sensor

Setting up the camera hardware

sudo raspi-config nonint do_camera 0

After this action reboot the raspberry

Setup

• Open the config.py file and configure the TOKEN_ID and CHAT_ID variables with your token_id and your chat_id

    # Variable to configure
    TOKEN_ID = 'Your token_id'
    CHAT_ID = 'Your chat_id'

Installing

Before installing set your token_id then:

sudo make install

Bot's commands

• /start : start the home monitoring system
• /stop : stop the home monitoring system
• /status : show the status of the monitoring system
• /photo : take a picture
• /video < delay > : records a video, by default delay is 60s
• /clean : remove all files in video folder
• /help : show help

Details

• By default, the duration of the video is set to 60s. If you want change this, you need to modify the VIDEO_TIME constant in config.py

• It's possible to add other commands to the bot in app.py with the decorator @bot.handler()

@bot.handler("/hello")		
def func_hello():		
    return bot.send_message("Hello World")		

Testing

make test

Uninstall

sudo make uninstall

Built With

• gpiozero
• telepot
• picamera