MiHomeAnalyzer - Detect Motion in Xiaomi's MJSXJ02HL security camera recordings

MiHomeForensics is an application that joins recordings from Xiaomi's MJSXJ02HL security camera and detect motion on them.

It uses one modified MotionDetector to detect motion on the specified videos.

This application was built in Python 3.9 (Windows 10 Pro) and Python 3.10 (Ubuntu 22.04 LTS).

It supports Windows and Linux (Developed and tested in Windows 10 Pro and Ubuntu 22.04 LTS).

Dependencies

FFmpeg

The only dependency required by this application is FFmpeg.

Click to see FFmpeg installation on Windows!

• Download the .7z file
  (Oficial Mirror, check it out here)
• Extract the contents to one folder named "ffmpeg"
• Place the folder in "C:\Program Files"
• Run the following command to add the folder to system variables:
  setx /m PATH "C:\Program Files\ffmpeg\bin;%PATH%

Click to see FFmpeg installation on Linux!

Run the commands:

• sudo apt update
• sudo apt install ffmpeg

Compilation / Python execution

In order to execute this application outside Autopsy you have to install the following libraries (tested on a Fresh Installation of both Operating Systems):

• codeferm, a self modified version of MotionDetector's code, can be found here
• opencv-python (version 4.5.3.56, tested on Windows, or 4.5.5.64, tested on Linux)
• ffmpeg-python
• psutil
• pyinstaller, if you want to compile recompile the application

Usage

As Python Script / Executable application

This application can be used as a Python Script / Executable application. There are two versions:

• Python version: can be found here
• Executable versions: can be found here

The executable versions does not need instalation.

They need arguments to work, use (-h) or (--help) argument to see a little usage example

Both the Executable application and the Python script need a config file to execute.

In Autopsy

In order to integrate MiHomeAnalyzer with Autopsy, there are two modules:

• MiHomeAnalyzer: uses the MiHomeForensics application in order to detect motion in joined videos
• MiHomeAnalyzer_Report: exports a HTML report with the results of the ingest module

Place both folders (MiHomeAnalyzer) and (MiHomeAnalyzer_Report) in the python_modules folder of Autopsy

Then, in order to execute MiHomeAnalyzer, you have to place in the same folder the Executable file for your Operating System

Authors

• 
  João Manuel Vieira Silva (Instituto Politécnico de Leiria - Portugal)

• 
  Pedro Pescadinha Veigas (Instituto Politécnico de Leiria - Portugal)

Mentors

• Patrício Domingues (Instituto Politécnico de Leiria - Portugal)
• Miguel Frade (Instituto Politécnico de Leiria - Portugal)
• Miguel Negrão (Instituto Politécnico de Leiria - Portugal)

FreeBSD License

Copyright (c) Laboratory of Cybersecurity and Digital Forensics at IPLeiria and Authors of the project.

All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

• Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
• Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.