https://github.com/boss294/securecam
SecureCam is a Python-based application designed to monitor a live camera feed for human presence using OpenCV's face detection. It provides advanced features such as recording videos when a face is detected, real-time FPS display, and user interaction through a GUI built with PyQt5.
https://github.com/boss294/securecam
detection-model face-recognition opencv python recording-app
Last synced: about 2 months ago
JSON representation
SecureCam is a Python-based application designed to monitor a live camera feed for human presence using OpenCV's face detection. It provides advanced features such as recording videos when a face is detected, real-time FPS display, and user interaction through a GUI built with PyQt5.
- Host: GitHub
- URL: https://github.com/boss294/securecam
- Owner: BOSS294
- Created: 2024-09-15T22:43:51.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-12-12T07:10:06.000Z (over 1 year ago)
- Last Synced: 2025-02-07T09:16:39.275Z (over 1 year ago)
- Topics: detection-model, face-recognition, opencv, python, recording-app
- Language: Python
- Homepage:
- Size: 778 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# SecureCam - Human Detection and Recording System
## Overview
**SecureCam** is a Python-based application designed to monitor a live camera feed for human presence using OpenCV's face detection. It provides advanced features such as recording videos when a face is detected, real-time FPS display, and user interaction through a GUI built with PyQt5. The app is suitable for use in personal or small-scale security monitoring systems.
## Features
- **Real-time Face Detection**: Detects human faces within a predefined box.
- **Auto Recording**: Starts recording when a face is detected within the box and stops after a specified duration or if no face is detected for a given time.
- **Video Overlay**: Displays FPS and timestamp on the video feed.
- **GUI Controls**:
- View recordings.
- Stop recording.
- View logs.
- Stop alert.
- **Logs System**: Tracks and displays system activities.
- **Text-to-Speech Integration**: Announces recording start and stop events.
## Requirements
The following libraries and tools are required to run SecureCam:
- Python 3.8 or later
- OpenCV (`cv2`)
- PyQt5
- pyttsx3
2. Use the GUI to monitor the camera feed and control the recording system.
### GUI Components
- **Camera Feed**: Displays the live video feed with detection overlays.
- **Info Panel**: Displays current date, time, and last detection information.
- **Logs Panel**: Displays a log of system events.
- **Control Buttons**:
- **View Recordings**: Placeholder for viewing recorded videos.
- **Delete Recordings**: Placeholder for deleting recordings.
- **View Logs**: Displays the system log.
- **Stop Recording**: Stops the current recording manually.
- **Stop Alert**: Placeholder for stopping alerts.
### Recording Behavior
- Recording starts when a face is detected inside the predefined green box.
- Stops if no face is detected for 20 seconds or when the maximum recording duration (10 minutes) is reached.
## Key Functions
### `is_face_in_box(x, y, w, h, box_x, box_y, box_size)`
Checks if a detected face lies within the predefined green box.
### `start_recording(frame, date_time)`
Starts recording a video with a unique filename based on the current timestamp.
### `stop_recording()`
Stops the video recording and releases the video writer object.
### `display_overlay(frame, fps)`
Adds an overlay to the video feed showing the current timestamp and FPS.
## Customization
- **Detection Box**: The detection box can be adjusted by modifying `box_x`, `box_y`, and `box_size`.
- **Recording Duration**: Modify `max_recording_duration` to change the maximum recording time.
- **Alert Messages**: Customize the text-to-speech messages in `start_recording()` and `stop_recording()`.
## License
This project is licensed under the MIT License. See the `LICENSE` file for details.
## Acknowledgements
- OpenCV for computer vision tools.
- PyQt5 for GUI development.
- pyttsx3 for text-to-speech functionality.