DIY opensource intruder detection device

​In this project you will create an intruder detection device that will check if somebody is inside your house / room when you are out using a PIR sensor, if the PIR sensor detects somebody it will take a (set of) picture(s) of the intruder. The pictures will be sent to your telegram bot channel wherever you are. You can also add some “scare away” tactics, like trigger an alarm sound or a pre-recorded voice message.

Check lastest updates at site


To build this device you need:

Basic building instructions

  • Install raspbian distro, with Python3 and Telepot and PiCamera modules using pip3 or apt
  • Install Telegram and create a bot using BotFather and following the instructions
  • Install PiCam and PIR Sensor (Passive InfraRed presence sensor) hardware on your Raspberry Pi
  • Check if all is working separately
  • Set the python script telegram key and chat id from BotFather telegram data
  • Install espeak (sudo apt-get install espeak)
  • Run the python script

Basic usage instructions

  • Start the script
  • Open the telegram bot that you created before and control the script using the built-in commands


  • enable pir: if PIR sensor is enabled, when PIR is triggered, the script will take a picture and send it to your bot channel
  • disable pir: if PIR sensor is disabled, never takes a picture automatically (when you are at home, PIR sensor must be disabled to avoid a picture flood)
  • show: take a real-time picture and send it to the telegram bot channel
  • say TEXT: read the TEXT string through the speaker