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
3 Sep 08, 2022
2 Feb 20, 2022
120 Nov 30, 2022
5 Nov 05, 2022
1 Nov 07, 2021
2 Nov 07, 2022
6 Dec 06, 2022
2 Oct 21, 2021
6.4k Dec 31, 2022
1 Jan 16, 2022
0 Jan 20, 2022
44 Dec 24, 2022
8 Oct 06, 2022
2 Jan 04, 2023
114 Dec 21, 2022
727 Jan 02, 2023
32 Jul 02, 2022
105 Oct 22, 2022
372 Jan 08, 2023
2 Jan 15, 2022