Cheeto Cam
A live window onto one orange cat and the doorstep he guards
- 9,377
- Sightings logged
- 2,647
- Visits
- April 2025
- Watching since













01 The story
Where Critter Cam started, and still running at cheeto.cam. Whenever the Raspberry Pi by the front door spots Cheeto, my orange tabby, his photo, the weather and a short caption written on the Pi go up on the site, grouped into visits with highlights like his longest streak and favourite hour. Since April 2025 it has logged more than 9,300 sightings.
Cheeto Cam started in December 2024 as a Python script on a Raspberry Pi that watched a USB webcam for one orange cat and emailed a photo when it saw him. Over the next year it picked up YOLO detection, Gemini-written captions, weather, a hosted database, Pushover alerts and a web dashboard that made time-lapse GIFs. The detection history starts in April 2025.
cheeto.cam is that dashboard, public. It is one static page on Firebase Hosting (vanilla JS, Bootstrap and ApexCharts) that reads from the same self-hosted backend as the Critter Cam app, through a Cloudflare Tunnel, and keeps a cache in the browser. The Daily tab shows the newest visit, highlights and a wall of detections; Timeline and Lifetime chart the visits and build time-lapse GIFs right in the browser.
The cameras changed over time: an overhead doormat camera from April 2025 to July 2026 (about 5,300 detections), then a front-door camera from August 2026. The older captions were written by Gemini; the newer ones come from Florence-2 running on the Pi. Everything that made it work for one cat became the core of Critter Cam, the app version for any household and any pet.
▶ Film
02 What it does
- 01
Spots Cheeto on a Raspberry Pi by the front door and posts the photo, the weather and a caption to cheeto.cam
- 02
Groups sightings into visits, with highlights like his longest streak and favourite hour
- 03
Daily, Timeline and Lifetime views, with charts of visits by hour, weekday, month and weather
- 04
Time-lapse GIFs of a day or his whole history, built in the browser
- 05
Any photo opens full size and can be downloaded
- 06
Started as a script that emailed a photo whenever he turned up (December 2024)
05 By the numbers
- 9,377
- Sightings logged
- 2,647
- Visits
- April 2025
- Watching since
- 3
- Cameras so far
06 Stack
App
- Flutter (Android, iOS)
- Kotlin home-screen widget
- Swift notification service extension
- fl_chart
- video_player / just_audio
- Vanilla JS PWA dashboard
Backend
- Python detector on Raspberry Pi 5
- Self-hosted Supabase stack (Kong, PostgREST, GoTrue, Realtime, Storage)
- FastAPI push dispatcher
- ntfy
- Firebase Cloud Messaging
- APNs (HTTP/2, direct)
Data
- PostgreSQL with row-level security and household RPCs
- Supabase Storage (JPEG frames and thumbnails)
- On-Pi embeddings and prototypes (.npz)
Infrastructure
- Docker Compose on a Lenovo ThinkCentre M700 Tiny (Debian)
- Cloudflare Tunnel (no inbound ports)
- systemd units per camera
- Nightly pull-based backups
- Prometheus / Grafana / cAdvisor (LAN only)
- Firebase Hosting (dashboard)
- ESPHome and Arduino firmware for wireless cameras
- OpenSCAD outdoor enclosure
Tooling
- Ultralytics YOLO11n
- open_clip ViT-B-32-quickgelu
- Microsoft Florence-2-base (transformers)
- OpenCV
- ffmpeg / libx264
- pytest
- GitHub Actions (iOS build, TestFlight)
- OpenWeatherMap
Lines of code (approx.)
- Dart17,285
- Python6,895
- SQL4,841
- HTML3,109
- CSS1,135
- Arduino C++726
≈ 36,045 lines
Repositories
- cheetocam ↗public
- cat-detectorprivate
Four repos: cheetocam 109 commits (2024-12-02 to 2026-11-09), cat-detector 55 (2025-03-02 to 2026-11-12), cheetocam-app 69 (2026-07-31 to 2026-11-12) and cheeto-infra 36 (2026-07-31 to 2026-11-09). The 2026-11-12 commits add privacy, terms and support links to cheeto.cam and the app. The last substantial app release commit is 2026-08-11 (1.6.4). The detector's 2026-11-09 commit is real code: outdoor-camera audio, lighter live frames and ignoring birds.