A security camera script for the Raspberry Pi Zero W using the Waveshare RPi Camera (F).
The script will start recording a video when the magnetic reed switch is triggered (the door is opened) and the smartphone is not connected to the Raspberry Pi (bluetooth and/or WiFi). The recording will stop when the magnetic reed switch is triggered again (the door is closed).
Integrations:
- Magnetic Reed Switch: Integration with a magnetic reed switch to detect door open/close events and trigger recording accordingly.
- WIFI Detection: Integration with WiFi Access Point to allow user to use bluetooth or WiFi to not trigger recording. Allows user to view recorded videos in the web interface when outside of the home network.
- Bluetooth Detection: Integration with Bluetooth to allow user to use bluetooth to not trigger recording.
- Raspberry Pi Zero W (or Raspberry Pi Zero WH)
- Headers for the Raspberry Pi Zero W if you did not choose a Raspberry Pi Zero WH (if you do not feel comfortable soldering the headers you can use solderless headers such as these here)
- Waveshare RPi Camera (F) or another compatible camera module
- Flexcable adapter for the camera module
- Bluetooth-enabled device (e.g., a smartphone) to pair with the Raspberry Pi
- KY-025 module (Magnetic reed switch)
- a bunch of Dupont Jumper Wires
- Breadboard (optional)
- DS3231 Real Time Clock Module
The following sections will explain how to set up the Raspberry Pi Zero W. It is assumed that the Raspberry Pi Zero W is already set up and running (Optional - set up VNC if you have a hard time working in a headless setup). If you need help setting up the Raspberry Pi Zero W, please refer to the Raspberry Pi Documentation.
-
The Instructions to the hardware setup can be found here. If you are new to the project, please start here.
They explain how to connect the camera module and the magnetic reed switch to the Raspberry Pi and serve as entry point to the project. -
The Instructions to the WiFi setup can be found here.
They explain how to set up the Raspberry Pi as an access point and how to connect to it. This will be necessary to connect to the Raspberry Pi when outside of the home network and to access the web interface. - The Instructions to the Bluetooth setup and the script setup can be found here. They explain how to pair the Raspberry Pi with a Bluetooth device and how to set up the script.
Once the script is running, the Raspberry Pi will start recording a video when the magnetic reed switch is triggered (the door is opened) and the smartphone is not connected to the Raspberry Pi (bluetooth and/or WiFi). The recording will stop when the magnetic reed switch is triggered again (the door is closed).
- Web Interface: A user-friendly interface to view recorded videos. WIP.
- Captive Portal: Captive portal to open Web Interface when connecting to the Raspberry Pi's WiFi.
- System Monitor: A system monitor to view the status of the Raspberry Pi (e.g., CPU temperature, CPU usage, RAM usage, etc.).
- Improved Error Handling: Improved error handling to prevent the script from crashing, server from freezing, etc.
This section will be populated with common issues and their solutions as they are identified.
If you'd like to contribute to this project, please follow these guidelines:
- Fork the Repository: Create a fork of this repository to your account.
- Clone the Fork: Clone the forked repository to your local machine.
- Create a New Branch: Always create a new branch for your changes.
- Make Changes: Implement your changes, enhancements, or bug fixes.
- Commit and Push: Commit your changes and push them to your fork.
- Create a Pull Request: Create a pull request from your fork to the main repository.
This project is licensed under the MIT License. Please see the LICENSE file for more details.