A python package for controlled and automated image and video recording with the raspberry pi
Project description
pirecorder
A Python package for controlled and automated image and video recording with the raspberry pi
Key Features
- Controlled recording using custom, easy-to-edit configuration files
- Record single images and videos, timelapses, and sequences of videos
- Configure camera settings interactively via a live camera stream
- Dynamically draw the region of interest for your recordings
- Automatic naming of files and folders with relevant and custom labels
- Easy scheduling and automating recordings in the future
- Direct control of all modules via simple terminal commands
- Convert (folders of) images and videos with resize, monitor, and label options
- Dedicated documentation website with detailed guides and tutorials
- Jupyter notebook tutorial files
Modules
pirecorder consists of a main PiRecorder
module to run image and video recordings, stream
and camconfig
modules with interactive user interfaces for help setting up, calibrating, and configuring the camera, a schedule
module for scheduling future recordings, and a convert
module for the easy converting of (folders of) recorded images and videos.
Install
To install the latest release, simply open a terminal window and enter:
pip install pirecorder
To install the latest development version, enter:
pip install git+https://github.com/jollejolles/pirecorder.git --upgrade
Dependencies
pirecorder builds strongly on the picamera package, uses numpy, pyyaml, and opencv for some of its core functionality, and relies on various utility functions of the accompanying pythutils package. Scheduling functionality is based on CronTab and the associated python-crontab package. All dependencies are automatically installed with pirecorder except for:
- OpenCV: has to be manually installed due to its various dependencies on raspberry pi. Click here for a quick install guide.
- FFmpeg: is only needed for the convert functionality of pirecorder. Click here and here for guides to install on raspberry pi and OS X respectively.
Documentation
For detailed documentation and tutorials about pirecorder and all its functionalities, see the dedicated website jollejolles.github.io/pirecorder/.
- quick guide
- the pirecorder package
- setting up your raspberry pi
- installing pirecorder
- position and calibrate the camera
- configure recording settings
- configure camera settings
- record and schedule recordings
- converting media
- run from the command line
Development
pirecorder is developed by Dr Jolle Jolles, a research fellow at the Max Planck Institute of Animal Behavior, and at the Zukunftskolleg, Institute of Advanced Study at the University of Konstanz.
For an overview of version changes see the CHANGELOG and for detailed changes see the commits page. Please submit bugs or feature requests to the GitHub issue tracker here.
Citing
pirecorder was originally developed with the Biological Sciences in mind. If you use pirecorder in your research, please cite it as follows:
@misc{Jolles2019,
title = {pirecorder: controlled and automated image and video recording with the raspberry pi},
author = {Jolles, Jolle W.},
year = {2019}
url = {http://doi.org/10.5281/zenodo.2529515},
doi = {10.5281/zenodo.2529515}
}
License
Released under a Apache 2.0 License. See LICENSE for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.