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
Status
LiveLive at cheeto.cam, and the camera still logs Cheeto's visits every day.
Platforms
Raspberry Pi, Web
Role
Solo: hardware, detector, dashboard
Timeline
Dec 2024 – Nov 2026164 commits
Version
Live at cheeto.cam

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

Sixteen months on the doorstep, from April 2025, in five seconds of real photos

02 What it does

  1. 01

    Spots Cheeto on a Raspberry Pi by the front door and posts the photo, the weather and a caption to cheeto.cam

  2. 02

    Groups sightings into visits, with highlights like his longest streak and favourite hour

  3. 03

    Daily, Timeline and Lifetime views, with charts of visits by hour, weekday, month and weather

  4. 04

    Time-lapse GIFs of a day or his whole history, built in the browser

  5. 05

    Any photo opens full size and can be downloaded

  6. 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

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.