https://github.com/eshwinrio/room-surveillance
Room surveillance program with OpenCV for image processing and Paramiko/SCP for file transfer. This program was written for personal purposes, feel free to use it.
https://github.com/eshwinrio/room-surveillance
opencv opencv-python paramiko python3 scp ssh
Last synced: about 1 month ago
JSON representation
Room surveillance program with OpenCV for image processing and Paramiko/SCP for file transfer. This program was written for personal purposes, feel free to use it.
- Host: GitHub
- URL: https://github.com/eshwinrio/room-surveillance
- Owner: eshwinrio
- License: mit
- Created: 2025-03-24T14:02:29.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-24T15:00:10.000Z (about 1 year ago)
- Last Synced: 2025-03-24T15:35:51.487Z (about 1 year ago)
- Topics: opencv, opencv-python, paramiko, python3, scp, ssh
- Language: Python
- Homepage:
- Size: 8.79 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Room Surveillance
This project is a room surveillance system that monitors and records activities within a specified area using a camera.
## Features
- Real-time video monitoring
- Motion detection
- Recording and storing video footage
- Backing up footages to a SSH enabled server
## Installation
To install and run this project, follow these steps:
1. **Clone the repository:**
```bash
git clone https://github.com/yourusername/room-surveillance.git
cd room-surveillance
```
2. **Create a virtual environment:**
```bash
python -m venv venv
source venv/bin/activate # On Windows use `venv\Scripts\activate`
```
3. **Install the required dependencies:**
```bash
pip install -r requirements.txt
```
4. **Run the application:**
```bash
python main.py
```
## Usage
1. Ensure your camera is connected and recognized by your system.
2. Run the application using the command above.
3. The system will start monitoring and recording based on motion detection.
4. Access the recorded footage in the directories specified in your .env or the defaults `~/recordings`.
## Contributing
Contributions are welcome! Please fork the repository and submit a pull request.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.