https://github.com/amirbeek/pihomesecuritysystem
Advanced Raspberry Pi-based security system featuring real-time motion detection, live video streaming, and immediate alerts through email. Equipped with a camera module, this system provides robust home surveillance accessible via a web interface.
https://github.com/amirbeek/pihomesecuritysystem
flask gpio linux pi raspberry-pi
Last synced: 3 months ago
JSON representation
Advanced Raspberry Pi-based security system featuring real-time motion detection, live video streaming, and immediate alerts through email. Equipped with a camera module, this system provides robust home surveillance accessible via a web interface.
- Host: GitHub
- URL: https://github.com/amirbeek/pihomesecuritysystem
- Owner: Amirbeek
- License: mit
- Created: 2025-03-18T20:49:02.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-09T14:27:04.000Z (about 1 year ago)
- Last Synced: 2025-06-10T23:05:41.290Z (about 1 year ago)
- Topics: flask, gpio, linux, pi, raspberry-pi
- Language: Python
- Homepage:
- Size: 42.4 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PiHomeSecuritySystem
## Overview
PiHomeSecuritySystem is an advanced Raspberry Pi-based security system that leverages real-time motion detection, live video streaming, and immediate email alerts to provide robust home surveillance. This system is accessible via a web interface, allowing users to monitor their home remotely.And Machine Learning implemented, the model is Human detection from taken image
## Features
- **Real-Time Motion Detection**: Uses the HC-SR505 motion sensor to detect movement.
- **Email Alerts**: Sends an email with a photo attachment when motion is detected.
- **Live Video Streaming**: Streams live video which can be accessed through the web interface.
- **Local Photo Storage**: Saves photos triggered by motion events locally for later review.
## Hardware Components
- Raspberry Pi 5
- Camera Module (MF130)
- HC-SR505 Motion Sensor
- LEDs for visual indication of system status
## Software Components
- Python for backend logic
- Flask for the web interface
- `dotenv` for environment variable management
- `gpiozero` and `picamera` for interfacing with the hardware
- `yagmail` for sending emails
## Human Detection from Image
[Kaggle Dataset URL](https://www.kaggle.com/datasets/constantinwerner/human-detection-dataset)
## Setup
1. **Install Dependencies**:
```bash
pip install Flask gpiozero picamera yagmail python-dotenv
```
2. **Clone the Repository**:
```
git clone https://github.com/Amirbeek/PiHomeSecuritySystem.git
```
3. **Set Environment Variables: Create a .env file in your project root with the following keys**:
```
MAIN_EMAIL=your-email@example.com
RECEIVER_EMAIL=receiver-email@example.com
MAIL_PASSWORD=your-email-password
```
## Running the Project
Navigate to the project directory and run:
```
python server.js
```
## Project Documentation Images
- 
- 
- 
- 
## Improvements
- **Enhance Live Streaming**: Implement adaptive bitrate streaming for better performance under varying network conditions.
- **Web Interface Enhancements**: Improve the UI/UX design to make it more user-friendly and visually appealing.
- **Expand Notification Options**: Add support for SMS notifications or integration with mobile apps.
## Contributing
Contributors are welcome to improve the PiHomeSecuritySystem. Here are some areas where you can help:
- Implementing new features such as the suggested improvements.
- Bug fixes and performance enhancements.
- Documentation and examples.
## License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE) file for details.
## Acknowledgments
Big thanks to everyone who has contributed to this project so far!