{"id":25863859,"url":"https://github.com/pageauc/pi-timolo2","last_synced_at":"2026-04-13T17:05:53.307Z","repository":{"id":278021479,"uuid":"934258569","full_name":"pageauc/pi-timolo2","owner":"pageauc","description":"Raspberry PI-TIMOLO2 ( PI-TImelapse, MOtion, LOwLight ) uses RPI libcamera/picamera2 and OpenCV for Motion Tracking.  Python3  Bullseye or later.  Auto Low Light long exposures. Supports pantilt pano image stitching. Auto Sync files with rclone remote storage services. ","archived":false,"fork":false,"pushed_at":"2025-02-24T15:01:53.000Z","size":2407,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-24T16:24:56.274Z","etag":null,"topics":["curl-install","image-stitching","libcamera","long-exposure","lowlight","makevideo","motion-tracking","opencv","panorama-image","pantilthat","picamera","picamera2","plugins","raspberry-pi","rclone","supervisor","timelapse","timelapse-videos","webserver","whiptail-menu"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pageauc.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":"license.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-17T14:34:13.000Z","updated_at":"2025-02-24T15:01:56.000Z","dependencies_parsed_at":"2025-02-17T15:46:57.731Z","dependency_job_id":"8c235598-81cd-49c1-aaae-adddf7dcfd95","html_url":"https://github.com/pageauc/pi-timolo2","commit_stats":null,"previous_names":["pageauc/pi-timolo2"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pageauc%2Fpi-timolo2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pageauc%2Fpi-timolo2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pageauc%2Fpi-timolo2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pageauc%2Fpi-timolo2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pageauc","download_url":"https://codeload.github.com/pageauc/pi-timolo2/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241443282,"owners_count":19963744,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["curl-install","image-stitching","libcamera","long-exposure","lowlight","makevideo","motion-tracking","opencv","panorama-image","pantilthat","picamera","picamera2","plugins","raspberry-pi","rclone","supervisor","timelapse","timelapse-videos","webserver","whiptail-menu"],"created_at":"2025-03-02T00:26:44.895Z","updated_at":"2026-04-13T17:05:53.299Z","avatar_url":"https://github.com/pageauc.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PI-TIMOLO2 [![Mentioned in Awesome \u003cINSERT LIST NAME\u003e](https://awesome.re/mentioned-badge.svg)](https://github.com/thibmaek/awesome-raspberry-pi)\n### Raspberry (Pi)camera2, (Ti)melapse, (Mo)tion, (Lo)wlight\nAlso PanTilt Pano Image Stiching, PanTilt Sequence, Video Repeat, Quick Timelapse, Plugins, RClone Sync Folder Upload, Etc.\n\n## Quick Install or Upgrade\n**IMPORTANT** - It is suggested to run ***sudo apt-get update*** and ***sudo apt-get upgrade***\nbefore performing curl install, since it is **Not** performed by the ***timolo2-install.sh*** script\n\nInternet access is Required. Login to Raspberry Pi via ssh or locally with a terminal session open. In user home folder eg /home/pi \n\n##### Step 1\nPress GitHub copy icon on right side of code box below. Copied! will be displayed.                \n\n    curl -L https://raw.github.com/pageauc/pi-timolo2/master/source/timolo2-install.sh | bash\n\n##### Step 2\nOn RPI putty SSH or local terminal session, right click, select paste then Enter to download and run install script.  \n\nThe curl command will download and Run the GitHub [***timolo2-install.sh***](https://github.com/pageauc/pi-timolo2/blob/main/source/timolo2-install.sh) script. \nAn upgrade will not overwrite configuration files. Brief instructions are displayed at the end of the install.\n\n## Introduction\nPI-TIMOLO2 is primarily designed for ***headless operation*** and includes rclone that\ncan securely synchronize specified media folders and files with a users remote storage service of choice. This works well for remote security and monitoring\ncameras. Low Light uses a different algorithm based on a video stream thread frame px average below ***DARK_START_PXAVE*** per config.py setting.\n\nIt runs using libcamera and picamera2 python library, Bullseye (libcamera config), Bookworm Raspberry Pi OS and later.\nThis release points to original pi-timolo wiki that may sometimes not be relavent to pi-timolo2 features.\n\npi-timolo2 uses supervisor to launch timolo2-cam.py or timolo2-web.py in background.\nUse timolo2.sh, webserver.sh to manage (see help eg ***./timolo2.sh help***)\nor menubox.sh when supervisor processes installed.   \n\nPython scripts use python3 only and can take timelapse and/or motion tracking images/videos, separately or together. Will take\nlong exposure Night/Dark (lowlight) images for Time Lapse and/or Motion. Customization settings are saved in a [***config.py***](https://github.com/pageauc/pi-timolo2/blob/main/source/config.py) ,\nconf files and optional special purpose plugin config files located in the ***plugins*** folder. \nOptional plugin feature allows overlaying config.py settings with custom settings for specific tasks.  \n\nIncludes ***makevideo.sh*** to create timelapse or motion lapse videos from images. Use webserver to\nview images or videos. ***menubox.sh*** can admin settings and stop start, timolo2.cam.py and timolo2-web.py as background tasks. \n       \nFor more Details see [Github Wiki](https://github.com/pageauc/pi-timolo/wiki)   \n***Note:*** This points to original pi-timolo and some information might not be relavent or wrong for pi-timolo2\nA basic (simplified) lolight timelapse project can be found at https://github.com/pageauc/lolight\nThis was used for code testing as part of pi-timolo upgrade.\n\nGithub Issues are welcome.\n\n## Instructions\n\nRequires a [***Raspberry Pi computer***](https://www.raspberrypi.org/documentation/setup/) and a \n[***RPI camera module installed***](https://www.raspberrypi.org/documentation/usage/camera/).\nMake sure hardware is tested and works. Most [RPI models](https://www.raspberrypi.org/products/) will work OK. \nA quad core RPI will greatly improve performance due to threading. \n\nYou must have a recent version of Raspberry Pi OS. Bullseye, Bookworm or later 32 or 64 bit. Optional pantilt eg Pimoroni pantilt Hat.\nThis supports pano stitching mode, pantilt sequence on motion or timelapse sequences.\n\n1 - If config.py, makevideo.sh already exists then latest file will be a .new appended to the file name\n\n2 - If using Bulleye run sudo raspi-config, Interface Options, 3. \n    Make sure camera is NOT in Legacy picamera mode. Test camera. See commands below\n\t\n\tsudo raspi-config              % Check System Options Bullseye Only\n\tlibcamera-hello --list-cameras \n\tlibcamera-still -o sample.jpg  # you should see file if camera is working OK\n\n3 - You will need to create symlinks to enable supervisorctl operation per below.\n\tThis will allow proper operation of menubox.sh START/STOP menu picks.\n\tSee Details at [supervisor Readme.md](https://github.com/pageauc/pi-timolo2/tree/main/source/supervisor)\n\n    cd ~/pi-timolo2\n    ./timolo2-cam.sh install  # installs symlink for supervisorctl\n    ./timolo2-web.sh install\n    \n    ./timolo2-cam.sh help     # Display other options\n\t\n4 - To Test Run timolo2 execute the following commands in RPI SSH\n    or terminal session. Default is Motion Track On and TimeLapse On\n\n    cd ~/pi-timolo2\n    ./timolo2-cam.py\n\n5 - To manage pi-timolo2, Run menubox.sh per commands below\n\n    cd ~/pi-timolo2\n    ./menubox.sh\n\n#### Menubox.sh\npi-timolo2 has a whiptail administration menu system. The menu's allow\nstart/stop of timolo2-cam.py and/or timolo2-web.py as background tasks, as well as\nediting configuration files, making timelapse videos from jpg images, converting or joining mp4 files Etc.    \n\nTo run menubox.sh from ssh console or terminal session execute commands below.\n\n    cd ~/pi-timolo2\n    ./menubox.sh\n\n![menubox main menu](menubox.png)\n \n#### timolo2-web.py\nI have also written a standalone LAN based timolo2-web.py to allow easy access to pi-timolo2 image, video files\non the Raspberry from another LAN computer web browser.  There is no setup required but the display\nsettings can be customized via variables in the config.py file or via menubox admin menuing.     \n***NOTE:*** timolo2-web.py is normally run in background using menubox.sh, webserver.sh using supervisor    \nTo Test Run from ssh console or terminal session. \n    \n    cd ~/pi-timolo2\n    ./timolo2-web-sh install\n    ./timolo2-web.py        # Ctrl-c exits\n    ./timolo2-web.sh start  # runs web server in background\n    ./menubox.sh            # Menu system to manage programs and settings\n\n![webserver browser screen shot](webserver.jpg)\n\n\n## Reference Links \n[Detailed pi-timolo Wiki](https://github.com/pageauc/pi-timolo/wiki)  \n[my pi-timolo and other YouTube Videos playlist](https://www.youtube.com/playlist?list=PLLXJw_uJtQLa11A4qjVpn2D2T0pgfaSG0)    \n[MagPi Object Recognition using pi-timolo](https://magpi.raspberrypi.org/articles/wildlife-camera-object-recognition)    \n[makezine night vision project using pi-timolo](https://makezine.com/2016/05/26/spy-on-garden-critters-with-raspberry-pi-powered-night-vision/)    \n[hackster facial recognition using pi-timolo](https://www.hackster.io/gr1m/raspberry-pi-facial-recognition-16e34e)    \n[Neverending project timelapse using pi-timolo](https://www.theneverendingprojectslist.com/raspberrypiprojects/timelapse/)       \n[hedgehog camera using pi-timolo](http://www.sconemad.com/blog/hedgeycam/) and [step by step](https://oraclefrontovik.com/2016/08/28/a-step-by-step-guide-to-building-a-raspberry-pi-hedgehog-camera/)    \n[Museum Insect activity monitoring using pi-timolo](https://www.vam.ac.uk/blog/caring-for-our-collections/making-a-simple-insect-activity-monitor-using-a-raspberry-pi)    \n[Brett Beeson timelapse cloud project using pi-timolo](https://brettbeeson.com.au/timelapse-cloud/)     \n[Bird and Squirrel Detector](https://magpi.raspberrypi.org/articles/ml-based-bird-and-squirrel-detector)  \n\t\nGood Luck\nClaude Pageau \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpageauc%2Fpi-timolo2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpageauc%2Fpi-timolo2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpageauc%2Fpi-timolo2/lists"}