README.html

<h1 id="movemente_detector">Movemente Detector</h1>

<p>Movement Detector is a simple Java OpenCv application created as university project for the computer vision course at La sapienza, Rome.
It aims to detect when movements occur in front of a camera by using pixel based frame difference.
It also provides the ability to detect faces when a moderate quantity of movement is detected.</p>

<h2 id="requirements">Requirements</h2>

<ul>
<li>Java JRE 1.6+</li>
<li>OpenCV 2.2+</li>
<li>a webcam
(The other required libraries are shipped with Movement Detector in the <code>dist/lib/</code> folder)</li>
</ul>

<h2 id="running">Running</h2>

<p>You can find a runnable jar (last updated version) in the <code>dist</code> folder.<br/>
To run it simply use: <code>java -jar "movementDetector.jar"</code>.<br/>
On some OSs you can simply run the app by clicking on the movementDetector.jar file.</p>

<p><em>NB:</em> do not move or remove the <code>lib</code> folder</p>

<h2 id="known_issues">Known Issues</h2>

<p>If you use Movement Detector on Mac you may experience problems when starting the camera. Sometimes the application may get stuck and you have to force close and restart it again. It seems due to an OpenCV bug that does not handle threads in a safe way on mac. The problem will be resolved when openCV authors will release a fixed version. So we apparently have to wait. In the meanwhile any workaround would be heavily appreciated. So, please, contact us if you know some.</p>