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
8 Nov 25, 2022
1 Jan 14, 2022
2 Jan 07, 2022
27 Jan 05, 2023
42 Dec 06, 2022
2 Jul 01, 2022
7 Apr 17, 2022
2k Jan 08, 2023
5 Jan 15, 2022
1.1k Dec 10, 2022
183 Dec 28, 2022
192 Dec 20, 2022
14 Dec 28, 2022
0 Dec 12, 2021
19 Jan 05, 2022
11 Dec 30, 2022
25 Dec 23, 2022
756 Dec 27, 2022
237 Dec 23, 2022
150 Dec 24, 2022