Video Surveillance Software

• Download and install the dotnet core runtime for Mac OS
• Install homebrew: https://brew.sh/
• Open a terminal and run: brew install ffmpeg (you may need to install additional dependencies - check the output)
• ▼ Download the Agent DVR Mac OS files
• Run dotnet Agent.dll in a terminal window in the Agent folder.
• Open a web browser at http://localhost:8090 to start configuring Agent. If port 8090 isn't working check the terminal output for the port Agent is running on.

Run as a Service (optional):

Check our guide to run Agent as a service

Agent for Linux has been tested on Ubuntu 18.04, 19.10, Debian 10 and Linux Mint 19.3. Other distributions may require additional dependencies. Use the docker option if you have problems installing.

Dependencies:

• Agent currently uses the .Net core 3.1 runtime which can be installed by running: sudo apt-get update && \
sudo apt-get install -y apt-transport-https && \
sudo apt-get update && \
sudo apt-get install -y aspnetcore-runtime-3.1
• More information (you may need to add package references): https://dotnet.microsoft.com/download/dotnet-core/3.1

You also need to install FFmpeg v4.3.2 - one way of getting this via the terminal in Linux is:

• sudo apt-get update
• sudo add-apt-repository ppa:jonathonf/ffmpeg-4 OR sudo add-apt-repository ppa:savoury1/ffmpeg4 for Debian, Xenial and Focal OR sudo apt install ffmpeg for Ubuntu 20.04
• sudo apt-get update && \ sudo apt-get install -y ffmpeg

Important: Don't use the default ffmpeg package for your distro as it doesn't include specific libraries that Agent needs

Other libraries Agent may need depending on your Linux distro:

• sudo apt-get install -y libtbb-dev libc6-dev gss-ntlmssp

For Debian 10 (and possibly other distros):

• sudo wget http://security.ubuntu.com/ubuntu/pool/main/libj/libjpeg-turbo/libjpeg-turbo8_1.5.2-0ubuntu5.18.04.4_amd64.deb
• sudo wget http://fr.archive.ubuntu.com/ubuntu/pool/main/libj/libjpeg8-empty/libjpeg8_8c-2ubuntu8_amd64.deb
• sudo apt install multiarch-support
• sudo dpkg -i libjpeg-turbo8_1.5.2-0ubuntu5.18.04.4_amd64.deb
• sudo dpkg -i libjpeg8_8c-2ubuntu8_amd64.deb

For VLC support (optional):

• sudo apt-get install -y libvlc-dev vlc libx11-dev

Install Agent:

• ▼ Download the Agent DVR Linux files
• Unzip the Agent DVR files, open a terminal and run: dotnet Agent.dll in the Agent folder.
• Open a web browser at http://localhost:8090 to start configuring Agent. If port 8090 isn't working check the terminal output for the port Agent is running on.

Run as a Service (optional):

Check our guide to run Agent as a service

• Download the dotnet core runtime for Arm 32 (default) or Arm 64
• Setup the dotnet runtime (use dotnet-runtime-3.1.11-linux-arm64.tar.gz for 64 bit):
  sudo mkdir -p $HOME/dotnet
sudo tar zxf dotnet-runtime-3.1.11-linux-arm.tar.gz -C $HOME/dotnet
export DOTNET_ROOT=$HOME/dotnet
export PATH=$PATH:$HOME/dotnet
• Add the lines "export DOTNET_ROOT=$HOME/dotnet" & "export PATH=$PATH:$HOME/dotnet" into ~/.profile with "sudo nano ~/.profile".

If your OS doesn't already have a shared FFmpeg build installed (64 bit Buster on the Pi comes with compatible FFmpeg):

• Setup Snap (will reboot):
  sudo apt update
sudo apt install snapd
sudo reboot
• Install Snap Core: sudo snap install core
• Install FFmpeg (v4) - run this in a terminal window as you may be prompted for a password: snap install ffmpeg

Other libraries Agent may need depending on your distro:

• sudo apt-get install -y libtbb-dev libc6-dev gss-ntlmssp libatlas-base-dev
• sudo pip3 install opencv-contrib-python

For VLC support (optional):

• sudo apt-get install -y libvlc-dev vlc libx11-dev

Install Agent:

• Download the Agent DVR ▼ Arm 32 bit or ▼ Arm 64 bit files
• Create a new folder called Agent wherever you like.
• Unzip the Agent DVR files into this new folder, open a terminal and run: dotnet Agent.dll in the Agent folder.
• If you get a permission denied error call sudo chown -R user:group /path/to/Agent to change the ownership.
• Open a web browser at http://localhost:8090 to start configuring Agent. If port 8090 isn't working check the terminal output for the port Agent is running on.

Run as a Service (optional):

Check our guide to run Agent as a service

• A Docker image of Agent DVR will install Agent DVR on a virtual Linux image on any supported operating system. Please see the docker file for options.

  Important: The docker version of Agent includes a TURN server to work around port access limitations on Docker. If Docker isn't running in Host mode (which is only available on linux hosts) then you will need to access the UI of Agent by http://IPADDRESS:8090 instead of http://localhost:8090 (where IPADDRESS is the LAN IP address of your host computer).

  To install Agent under docker you can call (for example):
  
  docker run -it -p 8090:8090 -p 3478:3478/udp -p 50000-50010:50000-50010/udp \ -v /appdata/ispyagentdvr/config/:/agent/Media/XML/ \ -v /appdata/ispyagentdvr/media/:/agent/Media/WebServerRoot/Media/ \ -v /appdata/ispyagentdvr/commands:/agent/Commands/ \ -e TZ=America/Los_Angeles \ --name agentdvr doitandbedone/ispyagentdvr

  To run Agent if it's already installed:
  
  docker start agentdvr

  ---

  An nVidia compatible docker install is also available. This requires more setup than the standard docker install and is recommended for advanced users only. Please read the instructions on the docker page:
  Docker File (with nVidia support)

• Docker File

We've open sourced our Agent Plugins to help you get started building on top of our software. Check out our Github repo at https://github.com/ispysoftware/AgentDVR-Plugins.

Some of the things you can do with plugins:

• Process live video and audio
• Add overlays and audio effects
• Trigger alerts and detection events
• Create your own custom events to trigger Actions with extended parameters
• Tag recordings
• Call back into the Agent API by using HttpClient.