https://github.com/wajktor13/security-camera
GUI app that turns any camera into surveillance camera
https://github.com/wajktor13/security-camera
agh agh-university agh-wi agh-wiet gmail-api google-drive-api opencv opencv-python python python3 tkinter
Last synced: 7 months ago
JSON representation
GUI app that turns any camera into surveillance camera
- Host: GitHub
- URL: https://github.com/wajktor13/security-camera
- Owner: Wajktor13
- License: apache-2.0
- Created: 2023-03-19T15:38:17.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-10-02T17:51:18.000Z (about 2 years ago)
- Last Synced: 2025-01-20T17:24:15.894Z (9 months ago)
- Topics: agh, agh-university, agh-wi, agh-wiet, gmail-api, google-drive-api, opencv, opencv-python, python, python3, tkinter
- Language: Python
- Homepage:
- Size: 1.92 MB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: security-camera/assets/eye_icon.png
Awesome Lists containing this project
README
Security Camera
GUI app that turns any camera into useful surveillance camera
Report Bug or Request Feature
Table of Contents
## About The Project
Security Camera is an easy to use GUI app that provides functionalities similar to typical software of a surveillance camera (or even more!).
Some of the currently available features:
* neat GUI
* continuous and emergency recording
* motion detection
* buffer for emergency recordings
* system and email notifications
* uploading recordings to google drive
* various recording and preview modes
* saving settings to JSON
* debug log
* adjustable parameters (check usage)
The project came to life as a final assignment for a Python Course at the AGH University. It was created in collaboration with [@Xavvee](https://github.com/Xavvee).
### Built With
[](https://www.python.org/)
[](https://opencv.org/)
[](https://drive.google.com)
[](https://mail.google.com)
## Getting Started
### Prerequisites
* Python 3 (preferably >= 3.10)
* git
### Installation
1. Clone the repo (or download the latest release)
```sh
git clone https://github.com/Wajktor13/security-camera
```
2. Enter **_security-camera_** directory and install python libraries with pip
```sh
pip install -r requirements.txt
```
3. Enter **_security-camera/src_** directory and run **_run.py_** with Python
```sh
python run.py
```
### API
If you want to use email notifications and uploading to Google Drive, you need your own API keys.
_tutorial coming soon_
## Usage
## Roadmap
TODO:
- [ ] stats
- [ ] low resources consumption mode
- [ ] recording schedule
See the [open issues](https://github.com/github_username/repo_name/issues) for a full list of proposed features (and known issues).
## Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## License
Distributed under the Apache License 2.0. See [LICENSE](https://github.com/Wajktor13/security-camera/blob/main/LICENSE) for more information.
## Contact
Wiktor Wilkusz - wiktorwilkusz13@gmail.com
Project link: https://github.com/Wajktor13/security-camera
## Acknowledgments
* [Python](https://www.python.org/)
* [OpenCV](https://opencv.org/)
* [custom tkinter theme](https://github.com/rdbende/Forest-ttk-theme)