PiCameleon
Is a daemon program meant to provide the RaspberryPi Camera as a service while running according to a configuration.
Motivation
The RaspberryPi Camera can only be used by one process at a time. This can be very limiting when you need a camera feed from the camera to be used by many other programs or want to take pictures while some other program is using it.
However the camera has 4 ports that can be used simultaneously by the same process, this feature is exposed by the picamera library.
The feature is leveraged in this project to allow communication with the camera that would be difficult without it such as:
- requesting multiple streams at multiple qualities
- send video streams to multiple clients for processing
- requesting videos to be recorded or pictures to be taken while streaming
- detect motion continuosly and trigger camera features like snapshot and recording to file or even sending pictures to other services over http
Quick Usage Walkthrough
The program runs according to a configuration.
The configuration is seperated into 3 sections: camera_initialization_options, modes and trigger_responses
The camera_initialization_options is where you can specify the arguments to be passed to the PiCamera object from the picamera library, these are passed directly to the contructor.
The modes is where you can specify the operation modes in which the camera should run. These modes can be found modes folder. One can run the same mode with multiple configurations. The modes also run according to a certain schedule defined by a start and stop cron condition. These schedules can be found in the schedules folder, but you can write your own. The modes also have their own parameters that you can specify in the modes_config section for each instance.
Some modes (such as the motion_detection) can trigger. This means an action can be configured in response to it. The responses can be found in the trigger_responses folder. These have their own configuration section as they can have their own parameters. Some examples from these are record_to_file, snapshot and also triggering external services over http.
Example configurations can be found in the configs folder.
Deployment
Launcing the daemon in a docker container is supported and also recommended. There are two Dockerfiles which only differ in their base image to support the RaspberryPi Zero and all the other versions of the Pi.
For the container to be able to access the camera however it has to run with these special flags: --privileged -v /opt/vc:/opt/vc --env LD_LIBRARY_PATH=/opt/vc/lib.
Full Example:
docker run -d --name picameleon --privileged -v /opt/vc:/opt/vc --env LD_LIBRARY_PATH=/opt/vc/lib -e CONFIG_FILE=stream_server_config.json picameleon:latest
27 Jun 8, 2022
10 Dec 23, 2022
51 Nov 21, 2022
2.8k Dec 30, 2022
29 Nov 30, 2022
238 Jan 8, 2023
10 Dec 23, 2022
3 Dec 19, 2021
4 Oct 19, 2022
66 Nov 24, 2022
6 Dec 13, 2022
18 Dec 15, 2022
1 Dec 16, 2021
28 Dec 02, 2022
5 Apr 27, 2022
61 Oct 05, 2022
15 Dec 22, 2022
1 Jan 31, 2022
15 Aug 10, 2022
27 Nov 05, 2022
2 Aug 03, 2022
151 Dec 31, 2022
2 Jan 01, 2022
1 Dec 08, 2021
1 Nov 24, 2021
5 Feb 07, 2022
671 Jan 05, 2023