It's a highly customizable tool that automatically saves live snapshots of Reolink security camera feeds using the Reolink APIs, and does not require an FTP server.
- Install Python requirements with
pip install -r requirements.txt
Write the Reolink camera ip, username, and password (seprated by a single comma "," and no spaces) in the credentials.txt file for each camera you want to configure (each camera goes in a new line):
192.168.0.10,username_1,password_1
192.168.0.11,username_2,password_2
Due to commas (,) being used as separators, they cannot be used in any of the passwords.
A non-admin user account is strongly recommended as its password will be used in plain-text (over the local network).
To create a new user, open your Reolink camera web-interface, then Settings > System > User Management > Add User.
NOTE: there seem to be issues with symbols in passwords. If an issue occurs, try changing to an alphanumeric-only password.
Once the script is launched, if an output directory has not been specified, the path of new snapshots will be:
$HOME/Surveillance/yyyymmdd/cam_*/yyyymmdd_HHMMSS_cam_*_snapshot.jpg
reosnap.py [-h] [-u USERNAME] [-q QUALITY] [-r RESOLUTION | --width WIDTH | --height HEIGHT] [-H HOURS | -m MINUTES | -s SECONDS] [-i INTERVAL] [-o OUTPUT] [-v] [-l]
| Short | Argument | Info |
|---|---|---|
-h |
--help |
show this help message and exit |
-u USER |
--username USER |
Camera username (default: snapshotuser) |
-r RES |
--resolution RES |
[low/medium/high/max] (default: medium) |
| / | --width W |
Width (height will be calculated) (default: 1856) |
| / | --height H |
Height (width will be calculated) (default: 1392) |
-o |
--optimize |
Enable image optimization (default: disabled) |
-q QUAL |
--quality QUAL |
Optimization quality [low/medium/high/max/0-100] (default: 40) |
-k |
--keep-og |
Keep original files (if optimization is enabled) |
-H H |
--hours H |
Delete snapshots older than H hours (default: 12) |
-m M |
--minutes M |
Delete snapshots older than M minutes |
-s S |
--seconds S |
Delete snapshots older than S seconds |
-i INT |
--interval INT |
Snapshot interval in seconds (default: 4) |
-O PATH |
--output PATH |
Path to output directory |
-t |
--tmux |
Run in tmux detached session |
-v |
--verbose |
Enable verbosity |
-l |
--license |
Show License |
Contributions are welcome, feel free to submit issues and/or pull requests.
This tool is neither affiliated with nor endorsed by Reolink in any way.
GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007
"ReoSnap" - Save live snapshots of Reolink camera feeds.
Copyright (C) 2023 Andrea Varesio https://www.andreavaresio.com/.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.
