rpi-surveillance
Make a surveillance camera from your Raspberry Pi 4!
The surveillance is built as following: the camera records 10 seconds video and if a motion was detected - sends the video to telegram channel.
The timestamp is printed on videos, so it is better to set the correct time on your Raspberry Pi.
The motion detection works in the following way: the camera’s H.264 encoder calculates motion vector estimates while generating compressed video. Using these vectors we threshold them by --magnitude-th argument. If more than --vectors-quorum vectors thresholded - mark current frame as containing motion. If there are more than --detection-frames consecutive frames with motion - motion detected.
Tested on Raspberry Pi 4 (4 RAM) + NoIR Camera V2.
Installation
Install package
Install Python 3 requirements:
pip3 install --user -r requirements.txt
Install provided .deb package:
sudo dpkg -i <path/to/downloaded/rpi-surveillance.deb>
sudo apt install -f
Note: the installation supposes that you already enabled camera module on your Raspberry Pi.
Create telegram bot and chat
- Write to
@BotFatherin telegram and create a bot:
/start
/newbot
<name of your bot>
<username of your bot>_bot
You will get the TOKEN. Save it for future use.
- Create a private channel where you will receive video sequences with motion.
- Add created bot to the channel (rerquires only "post messages" permission).
- Send message
testto the channel. - Run
/usr/lib/rpi-surveillance/get_channel_idto get the CHANNEL_ID. Save it for future use.
Usage
To launch surveillance just run rpi-surveillance with your TOKEN and CHANNEL_ID, for example:
rpi-surveillance --token 1259140266:WAaqkMycra87ECzRZwa6Z_8T9KB4N-8OPI --channel-id -1003209177928
You can set various parameters of the surveillance:
usage: rpi-surveillance [-h] [--config CONFIG] --token TOKEN --channel-id
CHANNEL_ID [--temp-dir TEMP_DIR] [--log-file LOG_FILE]
[--resolution {640x480,1280x720,1920x1080}]
[--fps {25,30,60}] [--rotation {0,90,180,270}]
[--duration DURATION] [--magnitude-th MAGNITUDE_TH]
[--vectors-quorum VECTORS_QUORUM]
[--detection-frames DETECTION_FRAMES]
optional arguments:
-h, --help show this help message and exit
--config CONFIG Path to config file.
--token TOKEN Token for your telegram bot.
--channel-id CHANNEL_ID
Telegram channel ID. If you don't have it please, send
a message to your channel and run /usr/lib/rpi-
surveillance/get_channel_id with your token.
--temp-dir TEMP_DIR Path to temporary directory for video saving before
sending to channel. Don't change it if you don't know
what you're doing.
--log-file LOG_FILE Path to log file for logging.
--resolution {640x480,1280x720,1920x1080}
Camera resolution. Default - 640x480.
--fps {25,30,60} Frames per second. Default - 25.
--rotation {0,90,180,270}
Frame rotation. Default - 0.
--duration DURATION Duration of videos in seconds. Default - 10.
--magnitude-th MAGNITUDE_TH
Magnitude threshold for motion detection (lower - more
sensitive). Defaults: for 640x480 - 15, for 1280x720 -
40, for 1920x1080 - 65.
--vectors-quorum VECTORS_QUORUM
Vectors quorum for motion detection (lower - more
sensitive). Defaults: for 640x480 - 10, for 1280x720 -
20, for 1920x1080 - 40.
--detection-frames DETECTION_FRAMES
The number of consecutive frames with detected motion
to send an alert.
Build
Build was done using dpkg-buildpackage.
53 Dec 27, 2022
11 Sep 25, 2022
148 Dec 29, 2022
6 Oct 8, 2022
1.1k Dec 26, 2022
24 Dec 9, 2022
1.5k Jan 5, 2023
37 Dec 24, 2022
2k Dec 26, 2022
31 Jul 22, 2022
6 May 07, 2022
36 Oct 27, 2022
6.2k Jan 01, 2023
21 Jul 27, 2022
112 Dec 23, 2022
486 Dec 20, 2022
656 Dec 29, 2022
791 Jan 06, 2023
0 Dec 28, 2022
7 Apr 04, 2022
1 Feb 23, 2022
21 Dec 07, 2022
232 Dec 31, 2022
3 May 11, 2022
1 Jan 12, 2022
15 Dec 22, 2022
1 Nov 12, 2021