Your monitoring sidekick & security safe haven.

Since most embedded computers are powered with ARM processors, we must compile OpenCV from source so we can use the libraries. While this could be cross compiled on a faster workstation, it's usually easier to compile everything on the native system itself. The setup steps below were written with intent for the Odroid C1+ running Lubuntu. Official precompiled versions of this image can be found in the odroid repository. There is also a wiki page that expands on the user manual, and both can serve as helpful reference guides when getting everything up and running. Writing the image to an SD card is the most critical piece, and this can be done using the same steps as that for a Rasberry Pi.

Once the Odroid is running, install git and run the command below to download this repository. On Lubuntu, git is installed with sudo apt-get -y install git.

git clone https://github.com/jjones646/cloudguard

Now, go into the directory that was created above, and run the below command to pull in the source files for OpenCV and FFmpeg.

cd ./cloudguard && git submodule update --init

Once the step above has finished downloading everything, you can then proceed to start compiling the libraries that will be needed for the CloudGuard to start.

./build/install-all.sh

Since it's impractical to have a monitor always connected to the device, most find it easier to connect via ssh from another computer. When doing this, make you to specify the -X flag for forwarding back any windows from the program.

ssh -X odroid@<ip-address>

Well...kinda. If all of the above steps worked for you, then you no longer have to find that old keyboard and mouse in the bottom of your closet everytime you want to see the activity of the CloudGuard.

The config.json file can be modified for fine-tuning the camera to your exact environment. This is also where you can set limits on when and how often images will be delivered to an off-site server.

The easiest way to check what a connected camera is pointing at is to set the window->enabled value to true. This will open a window showing the camera's view at startup of the program.

To run the program, simply run the cloudguard.py python file. The requirements.txt file contains python packages that may need to be installed for the program to run correctly. While all of the packages there may not be required, the file was generated from an Odroid that could successfully run the program without errors.

sudo pip install -r requirements.txt

python cloudguard.py

Some examples showing different experements can be found in the img directory.