This is a Network Video Recorder accessed through a web browser making it accessible from anywhere on PC or smart phone. Designed to run on a Raspberry pi, it has low power consumption and runs reliably 24/7. It requires network cameras providing RTSP streams with the video encoded as H264 or H265. Audio (G711 or AAC) is supported. The audio and video are split into separate streams for rendering on the client using Web Codecs for low latency.

PTZ camera as viewed with Google Chrome

Multi camera view on Google Chrome (edited for privacy)

Multi camera view showing stream and column selection form

• Complete system deployment using a single deb file, which is available pre-built for Raspberry pi 4 or 5 in the Releases section.
• Secure authenticated web access.
• Low latency (approx 0.4 seconds or less) live video and audio (network condition permitting). This application uses WebCodecs to achieve low latency, and this reduces the compatibility with FireFox, specifically FireFox does not support audio sampling rates below 48K, giving rise to bad audio quality. Also, currently, only FireFox Nightly for Linux supports HEVC in WebCodecs. Chromium based browsers work for all requirements of this application (hardware GPU decoding required for HEVC).
• Supports network cameras with RTSP streams H264/H265/audio (not USB cameras).
• Onvif support for device and capabilities discovery and PTZ control.
• View live stream from individual or all cameras.
• Recordings triggered by Motion service OR by FTP of an image from camera (can be used with cameras which can ftp an image on detecting motion), OR by a specified pull point event topic firing (on cameras which support it)
• Recordings of motion events, selectable by date and time.
• PTZ for cameras supporting this feature through Onvif.
• Quick reboot or setup of key camera parameters for SV3C or ZXTech type cameras.
• Hosting of camera admin page, This allows secure access to camera web admin outside the LAN. This feature requires access through port 446 as well as the usual https port 443. (This feature does not work with Firefox).
• Configuration editor supporting Onvif discovery of cameras and their capabilities. Can also find capabilities of a specified individual camera.
• email notification if public IP address changes (for when port forwarding is used).
• Initial unauthenticated set up of user account from LAN only. Subsequent changes can be done when logged in through existing account.
• Get NVR LAN IP addresses.
• Get Local Wi-Fi source details.
• Set up Wi-Fi connection.
• NVR includes NTP server for cameras to sync time without the need for them to connect to the internet.

• The .deb file produced with ./gradlew buildDebFile is set up to install on a Raspberry pi running Ubuntu 24.04 (Noble Numbat). Availability of dependencies may prevent installation on other Ubuntu versions.
• Requires network cameras which provide H264 or H265 (HEVC) video, and optionally audio via RTSP (G711/AAC). No video transcoding is done on the raspberry pi to keep CPU utilisation low
• The browser used must be able to display the video format used. Most browsers will support H264, but on some older machines, the GPU may not support H265 (HEVC) decoding. There are special chromium forks which can render H265 with software decoding (see Thorium and Special Chromium Build)
  • For Chromium based browsers running on Ubuntu 23.04 with VAAPI installed and a suitable Intel GPU, you may need to use the parameters --enable-features=VaapiVideoDecodeLinuxGL,VaapiVideoDecoder,VaapiVideoEncoder or in the case of Chromium or Brave, or any browser base of Chromium 131 or higher --enable-features=AcceleratedVideoDecodeLinuxZeroCopyGL,AcceleratedVideoDecodeLinuxGL,AcceleratedVideoEncoder in the command line to enable hevc decoding. This will also enable hardware decoding generally.
• Web admin hosting where the camera uses https and rstps (secure rtsp streaming from cameras) are not currently supported.
• This software has been tested with SV3C and ZXTech cameras and Reolink Wi-Fi doorbell. There could possibly be compatibility issues with some other camera types.
• 2 way audio (Onvif profile T) supported on the Reolink Wi-fi doorbell using firmware version v3.0.0.3308_2407315182.

• Set up Ubuntu 24.04 Server (Noble Numbat) on a Raspberry pi 4 or 5
  • NOTE: You can use the Edit Settings feature of the Raspberry pi Imager to set up the hostname, user account locale and enable ssh for the Raspberry pi, but DO NOT set up the Wi-Fi with this facility as the NVRs own Wi-Fi set up utility will then not work. The NVR uses nmcli to control the Wi-Fi whereas the Imager will set it up under wpa_supplicant which will make the Wi-Fi device unavailable to nmcli. This means you will need to do the initial setup on the Raspberry pi connected through Ethernet or a direct terminal.

•   sudo apt update
    sudo apt upgrade

• Using the deb file in the release section or one you have build yourself (see DEVELOPMENT.md) , Copy the deb file to the Raspberry pi.
• ssh to the Raspberry pi.

• # Install with
  sudo apt install ./security-cam_11.0.0_arm64.deb # (or whichever version you have built or downloaded from the release area)

• See SETTING-UP.md for how to set up user account, wifi, cameras etc.

You can find further documentation in these files: -

• STRUCTURE.md
• DEVELOPMENT.md
• TOMCAT.md
• FFMPEG.md
• SETTING-UP.md
• USING-THE-NVR.md
• README_CLOUD.md