pi-timolo  by pageauc

Raspberry Pi security monitoring via camera and OpenCV

created 10 years ago
574 stars

Top 57.0% on sourcepulse

GitHubView on GitHub
Project Summary

This project provides a headless security monitoring solution for Raspberry Pi using its camera module, OpenCV, and Python. It automates time-lapses, motion detection, low-light photography with twilight transitions, and file synchronization to remote storage via rclone, targeting hobbyists and users needing remote surveillance.

How It Works

PI-TIMOLO leverages the RPi camera module and OpenCV for image processing. It supports time-lapses, motion tracking, and low-light (long exposure) photography, with automatic twilight transitions based on light thresholds. Configuration is managed via config.py and conf files, with an optional plugin system for task-specific overrides. Rclone integration enables automatic, secure synchronization of captured media to remote storage.

Quick Start & Requirements

  • Install/Run: curl -L https://raw.github.com/pageauc/pi-timolo/master/source/pi-timolo-install.sh | bash
  • Prerequisites: Raspberry Pi computer, RPi camera module, Raspberry Pi OS (Bullseye or earlier recommended). Quad-core RPi recommended for performance.
  • Setup: The install script handles dependencies.
  • Docs: Detailed pi-timolo Wiki

Highlighted Details

  • Headless operation with remote configuration via rclone sync.
  • Automatic twilight transitions without requiring a real-time clock.
  • Includes utility scripts for video creation (makevideo.sh), H.264 to MP4 conversion (convid.sh), and a basic web server for viewing files.
  • Features a whiptail-based administration menu (menubox.sh) for managing processes and settings.

Maintenance & Community

The project is maintained by Claude Pageau. Further details and community interaction may be available via linked YouTube videos and featured articles on MagPi, MakeUseOf, and Hackster.

Licensing & Compatibility

The README does not explicitly state a license. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

The project recommends Raspberry Pi OS Bullseye or earlier; compatibility with newer OS versions (like Bookworm) is primarily addressed in a separate pi-timolo2 repository. The gdrive utility is no longer installed by default, with rclone being the current default.

Health Check
Last commit

2 months ago

Responsiveness

1 day

Pull Requests (30d)
0
Issues (30d)
0
Star History
7 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.