https://github.com/sverrenystad/intruder-alert
A face detection system that utilizes OpenCV's classifiers to identify and record faces in real-time video.
https://github.com/sverrenystad/intruder-alert
opencv python
Last synced: 2 months ago
JSON representation
A face detection system that utilizes OpenCV's classifiers to identify and record faces in real-time video.
- Host: GitHub
- URL: https://github.com/sverrenystad/intruder-alert
- Owner: SverreNystad
- Created: 2024-05-27T21:50:13.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-05-28T22:46:59.000Z (about 2 years ago)
- Last Synced: 2025-10-27T14:43:59.346Z (8 months ago)
- Topics: opencv, python
- Language: Python
- Homepage:
- Size: 501 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Intruder Alert
Have you ever wanted to know who's been snooping around your computer while you're away?
Several times, I've left my laptop unattended, only to return and find someone have been poking around (changing wallpapers, open inappropriate tabs, add button shortcuts, even fake blue screens of death) and you do not fancy just locking your computer. Then you need Intruder Alert!
**Intruder Alert** is a face detection system that utilizes OpenCV's classifiers to identify and record faces in real-time video. This system captures images of detected faces, logging the time of detection, which can be used for security monitoring and intruder detection purposes.
## Features
- Real-time face detection from webcam feed.
- Timestamped logging of detected faces.
- Headless mode for running on servers without a display (or on the laptop during lunch meetings or so).
- Saving detections as images for further analysis or evidence.
- Depth estimation using Depth Estimation model.
## Prerequisites
Ensure Python 3.11 or newer is installed on your machine. [Download Python](https://www.python.org/downloads/)
Then, install the required packages by running the following command in the project directory:
```bash
pip install -r requirements.txt
```
## Usage
To start the face detection, navigate to the project directory and run:
```bash
python main.py
```
The system will activate the webcam and begin scanning for faces. Detected faces will be displayed in real-time, and images will be saved in the detections/ directory under the project folder.
Press `q` while focused on the video window to quit the application.
### Headless Mode (aka Ninja Mode)
To run the system in headless mode, use the `--headless` flag:
```bash
python main.py --headless
```