Software

LINUX

Shinobi Installation

• Shinobi Installation
• Shinobi Configuration
• Adding an INSTAR Full HD Camera
• Setting up Motion Detection for your INSTAR IP Camera
• Default Motion Detection Settings
  • Global Detector Settings Primary Engine : Pixel Array
  • Motion Detection Primary Engine : Pixel Array
  • Traditional Recording

Shinobi is Open Source, written in Node.js, and real easy to use. It is the future of CCTV and NVR for developers and end-users alike. It is catered to by professionals and most importantly by the one who created it.

The easiest way to install, directly on metal, is through git. The following operating systems are supported:

• Ubuntu 17.10.1
• CentOS 7
• MacOS 10.7(+)

Become root to use the installer and run Shinobi. Use one of the following to do so.

Ubuntu 17.10.1:

sudo su

CentOS 7:

su

MacOS 10.7(+):

su

Download and run the installer:

bash <(curl -s https://gitlab.com/Shinobi-Systems/Shinobi-Installer/raw/master/shinobi-install.sh)

Shinobi Configuration

Create a Shinobi user by accessing http://<IP Address>:8080/super and login with:

user: admin@shinobi.video
password: admin

Click on Add User and create a default user for your Shinobi installation:

You can now switch to http://<IP Address>:8080/ and login with the default user you just created:

Adding an INSTAR Full HD Camera

We can start using Shinobi by clicking on the + Symbol in the top left and adding an ID and a readable Name for the camera we want to add in the Identity section. It is important to choose the Watch Only mode if you want to use the integrated Motion Detection:

For the Connection part we need to choose h.264 and the Video (RTSP) Path for our camera model (Note: that we are choosing the 11 path that represents the full resolution. If you are experiencing issues - like a stuttering video stream or high CPU loads - you can switch to 12 or 13 instead to set a lower resolution):

rtsp://<Camera IP Address>/11

Now close the configuration menu to save your settings. Open the side menu by clicking on the hamburger icon in the top left and click on the camera you just added. The video stream should show up in a floating viewport on the right (might take a few seconds - if it takes too long, consider using a smaller RTSP stream as stated above):

Setting up Motion Detection for your INSTAR IP Camera

Now click on the Wrench Button to get back to the configuration menu and switch the menu to Advanced Mode at the bottom of the floating window:

The menu will now offer a couple of additional configuration option - a couple of the relate to alarm features:

• Global Detector Settings: It is best to leave everything at it's default values - you can come back to it later to add some performance fine tuning here.
• No Motion Detector: An interesting feature is the inverted motion detection - do you want to make sure that your machine is working at all time? Set up Shinobi to notify you when it stopped.
• Audio Detector: Our RTSP stream contains both the video as well as the audio stream from our camera. Use the audio to trigger a recording in Shinobi.
• Object Detection: This function requires the additional installation of OpenCV and is out of the scope of this tutorial.

And last but not least, we have the classic Motion Detection:

Correction: the screenshot above set's the Recording Timeout to 5min - it is much more sensible to choose a value of 0.2, resulting in 12s alarm videos.

Here, again, we will leave most at the default settings and move on the Region Editor that allows us to define Motion Detection Areas that will be used to limit the area that will be watched by the detection algorithm:

Klick on the green + Button to add an area - the new area will be displayed in the top left corner of the camera video image. You can drag&drop each of the white anchor points to reposition them. Or click on the red line to add a new anchor (a right-click deletes a point). Klick on Close to save your settings.

When you scroll further down the config menu you will reach the rest of the motion detection settings - again, we will leave most of them at their default settings for now (to be further fine-tuned later on):

Close the configuration menu now and walk in front of your camera to trigger a few alarm recordings. The Shinobi offers a couple of ways to view our alarm videos:

• Event Log
• Video Grid
• Video List
• Time Lapse Recordings
• Power Viewer

We are going to show you the Power Viewer as seen in the screenshots below. Click on the button marked with the red arrow:

The Power Viewer will show you a timeline of all alarm recording events - the higher the red bars, the more motion was detected inside the video. Clicking on a bar in the timeline opens the recorded video.

Default Motion Detection Settings

Global Detector Settings Primary Engine : Pixel Array

Motion Detection Primary Engine : Pixel Array

Traditional Recording