{"id":22922979,"url":"https://github.com/boss294/securecam","last_synced_at":"2026-05-15T01:07:25.632Z","repository":{"id":267750501,"uuid":"857903855","full_name":"BOSS294/SecureCam","owner":"BOSS294","description":"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. ","archived":false,"fork":false,"pushed_at":"2024-12-12T07:10:06.000Z","size":797,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-07T09:16:39.275Z","etag":null,"topics":["detection-model","face-recognition","opencv","python","recording-app"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BOSS294.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-15T22:43:51.000Z","updated_at":"2024-12-12T07:10:57.000Z","dependencies_parsed_at":"2024-12-12T08:30:37.481Z","dependency_job_id":null,"html_url":"https://github.com/BOSS294/SecureCam","commit_stats":null,"previous_names":["boss294/securecam"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BOSS294%2FSecureCam","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BOSS294%2FSecureCam/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BOSS294%2FSecureCam/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BOSS294%2FSecureCam/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BOSS294","download_url":"https://codeload.github.com/BOSS294/SecureCam/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246658469,"owners_count":20813207,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["detection-model","face-recognition","opencv","python","recording-app"],"created_at":"2024-12-14T08:14:02.455Z","updated_at":"2025-10-27T08:07:11.225Z","avatar_url":"https://github.com/BOSS294.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SecureCam - Human Detection and Recording System\n\n## Overview\n**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.\n\n## Features\n- **Real-time Face Detection**: Detects human faces within a predefined box.\n- **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.\n- **Video Overlay**: Displays FPS and timestamp on the video feed.\n- **GUI Controls**:\n  - View recordings.\n  - Stop recording.\n  - View logs.\n  - Stop alert.\n- **Logs System**: Tracks and displays system activities.\n- **Text-to-Speech Integration**: Announces recording start and stop events.\n\n## Requirements\nThe following libraries and tools are required to run SecureCam:\n\n- Python 3.8 or later\n- OpenCV (`cv2`)\n- PyQt5\n- pyttsx3\n\n2. Use the GUI to monitor the camera feed and control the recording system.\n\n### GUI Components\n- **Camera Feed**: Displays the live video feed with detection overlays.\n- **Info Panel**: Displays current date, time, and last detection information.\n- **Logs Panel**: Displays a log of system events.\n- **Control Buttons**:\n  - **View Recordings**: Placeholder for viewing recorded videos.\n  - **Delete Recordings**: Placeholder for deleting recordings.\n  - **View Logs**: Displays the system log.\n  - **Stop Recording**: Stops the current recording manually.\n  - **Stop Alert**: Placeholder for stopping alerts.\n\n### Recording Behavior\n- Recording starts when a face is detected inside the predefined green box.\n- Stops if no face is detected for 20 seconds or when the maximum recording duration (10 minutes) is reached.\n\n\n## Key Functions\n### `is_face_in_box(x, y, w, h, box_x, box_y, box_size)`\nChecks if a detected face lies within the predefined green box.\n\n### `start_recording(frame, date_time)`\nStarts recording a video with a unique filename based on the current timestamp.\n\n### `stop_recording()`\nStops the video recording and releases the video writer object.\n\n### `display_overlay(frame, fps)`\nAdds an overlay to the video feed showing the current timestamp and FPS.\n\n## Customization\n- **Detection Box**: The detection box can be adjusted by modifying `box_x`, `box_y`, and `box_size`.\n- **Recording Duration**: Modify `max_recording_duration` to change the maximum recording time.\n- **Alert Messages**: Customize the text-to-speech messages in `start_recording()` and `stop_recording()`.\n\n\n## License\nThis project is licensed under the MIT License. See the `LICENSE` file for details.\n\n## Acknowledgements\n- OpenCV for computer vision tools.\n- PyQt5 for GUI development.\n- pyttsx3 for text-to-speech functionality.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboss294%2Fsecurecam","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fboss294%2Fsecurecam","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboss294%2Fsecurecam/lists"}