Motion detection & video recording software based on OpenCV, built for research on Bumblebees (hence the name).

Index

• Use case
• Examples
• Install
• Usage
• Configuration
• Changelog
• ToDo
• License

Use case

This software was built to meet the need of tracking, and/or recording clips of marked Bumblebee individuals in a scientific research project. It has been used with a Raspberry Pi 4[^1] and a Raspberry Pi HQ Camera[^2] pointed at the entrance of a Bombus terrestris nest, in order to record clips of the entry/exit events, based on motion. This considerably reduced the storage space required for the recordings and completely removed the need of post processing work, since it was only recording clips in which individuals appeared in the video frame.

bombuscv-rs offers realtime motion detection & video recording[^3] using camera input and can be directly used on fieldwork. However, using the video option, live camera input can be replaced with a pre-recorded video file: this is useful to remove dead moments from videos and reduce/remove the need of manual video trimming.

means this setup can be also reproduced in locations where no AC is available

Examples

Below a brief example of the produced video output:

https://user-images.githubusercontent.com/74802223/171311278-c5caf303-832f-46f6-a4cc-a3e05f823349.mp4

More examples can be found here.

Install

Clone the repository and build the project with cargo: sh git clone https://github.com/marcoradocchia/bombuscv-rs.git cd bombuscv-rs cargo build --release

Usage

``` bombuscv-rs 0.1.0 Marco Radocchia marco.radocchia@outlook.com OpenCV based motion detection/recording software built for research on bumblebees.

USAGE: bombuscv [OPTIONS]

OPTIONS: -d, --directory Output video directory -f, --framerate Video framerate --format Output video filename format (see https://docs.rs/chrono/latest/chrono/format/strftime/index.html for valid specifiers) -h, --help Print help information -i, --index /dev/video capture camera index -o, --overlay Enable Date&Time video overlay -q, --quiet Mute standard output -r, --resolution Video resolution (standard 16:9 formats) [possible values: 480p, 576p, 720p, 768p, 900p, 1080p, 1440p, 2160p] -v, --video

Configuration

All options can be set in a optional configuration file stored at $XDG_CONFIG_HOME/bombuscv/config.toml by default or at any location in the filesystem specified by setting BOMBUSCV_CONFIG environment variable. CLI arguments/flags override options defined in the configuration file. Note that if using video option in order to use bombuscv with a pre-recorded video input, framerate, resolution and overlay options are ignored: the first two are auto-detected from the input file using ffprobe (ffmpeg tool), while the last makes no sense if used with a non-live video feed; same rules apply to CLI arguments. Below listed an example configuration file: ```toml

/dev/video camera input

index = 0

input/output framerate (ignored if used with video)

framerate = 10.0

input/output resolution (ignored if used with video)

possible values (16:9 formats): 480p, 576p, 720p, 768p, 900p, 1080p, 1440p, 2160p

resolution = "720p"

date&time video overlay (ignored if used with video)

overlay = true

be quiet (mute stdout)

quiet = false

output video directory

directory = "~/output_directory/"

output video filename format (see

https://docs.rs/chrono/latest/chrono/format/strftime/index.html for valid specifiers)

format = "%Y-%m-%dT%H:%M:%S"

input video file (replaces live camera input; conflicts with index, overlay)

video = "~/input_video.mkv"

```

Changelog

Complete CHANGELOG.

ToDo

• [ ] Provide build & install instructions in README, as well as the instructions to install OpenCV.
• [ ] Make install script for automated installation on RaspberryPi.
• [x] Passing video or directory options in the configuration file using ~/<path> results in an error: in the Deserialize expanding ~ to absolute path is required.
• [x] Using video, date&time overlay generated on frame grabbed makes no sense: disable video overlay while using video option.
• [x] Add option to specify custom config path using env variables.
• [x] Add option to specify (in config file or via CLI argument) a custom output video filename formatter (must be chrono DateTime syntax).
• [x] Add thread signalling to interrupt grabber thread and gracefully terminate the execution.
• [x] Move logic from main to newly defined run.

License

GPLv3