Home

Awesome

PI-TIMOLO Mentioned in Awesome <INSERT LIST NAME>

Raspberry (Pi)camera, (Ti)melapse, (Mo)tion, (Lo)wlight

For Details See Program Features and Wiki Instructions and YouTube Videos

IMPORTANT: Raspbian Stretch and pi-timolo.py ver 11.11 and earlier has long exposure low light camera freezing issue due to kernel panic that requires a reboot to gain control of camera back per https://github.com/waveform80/picamera/issues/528 pi-timolo.py ver 11.12 has a fix to resolve issue but requires the latest Raspbian firmware. If you encounter camera freeze with latest Stretch image then you will need to run sudo rpi-update to update Stretch to latest firmware. Normal backup precautions are advised before doing the firmware update. See wiki Note: Raspbian Jessie works fine and does Not encounter freezing issue with long exposure low light operation.

Requirements

Requires a Raspberry Pi computer and a RPI camera module installed. Make sure hardware is tested and works. Most RPI models will work OK. A quad core RPI will greatly improve performance due to threading. A recent version of Raspbian operating system is Recommended.

Quick Install or Upgrade

IMPORTANT - It is suggested you do a Raspbian sudo apt-get update and sudo apt-get upgrade before curl install, since it is No longer performed by the pi-timolo-install.sh script

Step 1 With mouse left button highlight curl command in code box below. Right click mouse in highlighted area and Copy.
Step 2 On RPI putty SSH or terminal session right click, select paste then Enter to download and run script.

curl -L https://raw.github.com/pageauc/pi-timolo/master/source/pi-timolo-install.sh | bash

The command above will download and Run the GitHub pi-timolo-install.sh script. An upgrade will not overwrite configuration files.

Test Install

To Test Run default config.py - motion track(HD image) plus timelapse(5 min interval).

cd ~/pi-timolo
./pi-timolo.py

For More Details see Basic Trouble Shooting or pi-timolo Wiki

Description

PI-TIMOLO is primarily designed for headless operation and includes rclone that can securely synchronize specified media folders and files with a users remote storage service of choice. This works well for remote security and monitoring cameras. Camera config.py and conf settings can be easily administered remotely from a designated sync directory using watch-app.sh script using a crontab entry to periodically check for updates between the pi-timolo camera and a users remote storage rclone service name.

pi-timolo is python 2/3 compatible and can take timelapse and/or motion tracking images/videos, separately or together. Will take long exposure Night (lowlight) images for Time Lapse and/or Motion. Has relatively smooth twilight transitions based on a threshold light setting, so a real time clock is not required. Customization settings are saved in a config.py and conf files and optional special purpose plugin config files. Optional plugin feature allows overlaying config.py settings with custom settings for specific tasks.

Includes makevideo.sh to create timelapse or motion lapse videos from images, convid.sh to convert/combine h264 to mp4 format, a simple minumum or no setup web server to view images or videos and menubox.sh to admin settings and stop start pi-timolo and webserver as background tasks.

For more Details see Github Wiki

Minimal Upgrade

If you are just interested in a minimal upgrade (must have pi-timolo previously installed) from a logged in ssh or terminal session execute the following commands.

cd ~/pi-timolo
sudo apt-get install python-opencv
cp config.py config.py.old
cp pi-timolo.py pi-timolo.py.old
wget -O config.py https://raw.github.com/pageauc/pi-timolo/master/source/config.py
wget -O pi-timolo.py https://raw.github.com/pageauc/pi-timolo/master/source/pi-timolo.py    

To implement webserver3.py (Buster or Later) perform the following

cp webserver.py webserver2.py
cp webserver3.py webserver.py

Edit config.py to transfer any customized settings from config.py.old

Manual Install or Upgrade

From logged in RPI SSH session or console terminal perform the following. You can review the pi-timolo-install.sh script code before executing.

cd ~
wget https://raw.github.com/pageauc/pi-timolo/master/source/pi-timolo-install.sh
more pi-timolo-install.sh    # Review code if required
chmod +x pi-timolo-install.sh
./pi-timolo-install.sh

Menubox

pi-timolo has a whiptail administration menu system. The menu's allow start/stop of pi-timolo.py and/or webserver.py as background tasks, as well as editing configuration files, making timelapse videos from jpg images, converting or joining mp4 files Etc.

To run menubox.sh from ssh console or terminal session execute commands below.

cd ~/pi-timolo
./menubox.sh

menubox main menu

Webserver

I have also written a standalone LAN based webserver.py to allow easy access to pi-timolo image and video files on the Raspberry from another LAN computer web browser. There is no setup required but the display settings can be customized via variables in the config.py file or via menubox admin menuing.
NOTE: webserver.py is normally run in background using menubox.sh, webserver.sh or from /etc/rc.local
To Test Run from ssh console or terminal session.

cd ~/pi-timolo
./webserver.py

webserver browser screen shot

shutdown.py

This will safely halt the raspberry pi when a momentary switch is held for a specified number of seconds for details see wiki How to Use shutdown.py

Reference Links

Detailed pi-timolo Wiki
my pi-timolo and other YouTube Videos playlist
MagPi Object Recognition using pi-timolo
makezine night vision project using pi-timolo
hackster facial recognition using pi-timolo
Neverending project timelapse using pi-timolo
hedgehog camera using pi-timolo and step by step
Museum Insect activity monitoring using pi-timolo
Brett Beeson timelapse cloud project using pi-timolo
Bird and Squirrel Detector

Good Luck Claude Pageau