Kalina’s official litter box log.
Every visit. Every second. Scientifically recorded by a PIR sensor that has seen more than it would like to.
Meow Facts purr-ocessed automatically
Cats sleep 12 to 16 hours a day on average.
Rush Hour
Visits by time of day, last 30 daysKalina’s Commit History
One paw per day, last 12 weeksThe Log
The quips are the original German push notifications Kalina’s humans get on their phones. We left them untranslated – it’s her native language.
Guestbook paw prints from around the world
About Kalina the leading lady
Profile
- Name
- Kalina
- Breed
- British Shorthair
- Occupation
- Full-time house cat
- Expertise
- Scratching, sleeping, ignoring sensors
- Workplace
- Hooded litter box, PIR-monitored
- Audience
- everyone watching right now
- Awareness
- has no idea this site exists
The British Shorthair
The British Shorthair is one of the best-known pedigree cats: round face, sturdy, compact body, dense plush coat and a remarkably laid-back temperament. The most famous variety is the grey-blue “British Blue”.
Calm cats make ideal candidates for a litter box log: they come in, do their business and leave. All the sensor has to do is count.
How It Works for the curious and DIYers
A motion sensor under the lid of a hooded litter box, a Wi-Fi microcontroller and two small servers on the home network. That’s all it takes to log every bathroom visit of a cat down to the second.
- PIR sensorHC-SR501 senses Kalina’s body heat
- ESP8266ESPHome handles hold time and minimum duration
- Home Assistantsends push quips and reports every visit
- PocketBasestores the log and live status
- This sitelistens in live via realtime
Wiring
| HC-SR501 | NodeMCU v2 | Why |
|---|---|---|
| + (VCC) | Vin | ≈ 5 V from USB. The PIR has its own 3.3 V regulator and needs at least 4.5 V – the 3V3 pin would leave only about 2.6 V. |
| OUT | D5 (GPIO14) | Outputs 3.3 V, connects directly. Not a boot pin, and D1/D2 stay free for I²C. |
| − (GND) | GND | The GND right next to Vin. |
- Jumper set to H (retriggerable), time pot turned fully left (≈ 3 s). ESPHome handles the actual hold time.
- A decent USB power supply (≥ 1 A) prevents false alarms caused by voltage dips while the Wi-Fi transmits.
How the sensor counts
- After power-up, the PIR warms up for 60 s.
- The first movement starts a visit; after 150 s of stillness it’s over.
- “Occupied” only shows after 10 s in the box – a quick peek doesn’t count.
- Session length is net: occupied time minus hold time.
- When cleaning, a button switches on maintenance mode: nothing counts for 120 s, a double click ends it early.
The 3D-printed enclosure


- Outer dimensions about 63 × 59 × 32 mm, two parts
- The top part sticks to the inside of the lid with LSE tape (3M VHB). The lid is PP, and regular tape won’t hold on it.
- NodeMCU and PIR snap into the bottom part, which is screwed on from below with three 4.5 × 20 countersunk screws.
- Asymmetric hole pattern: the bottom part only fits one way.
- The lens dome protrudes about 9 mm downwards.
- Printed in PETG, not PLA: ammonia and moisture don’t get along with PLA.
- No ventilation slots. Designed parametrically in OpenSCAD.
FAQ and honest answers
What is CatShit.live?
CatShit.live is the public litter box log of Kalina, a British Shorthair cat. A motion sensor in her litter box detects every visit. This site shows live whether the box is occupied right now, plus records, statistics and every single visit. A private fun project with no ads and no tracking.
How does the sensor detect a visit?
A passive infrared motion sensor (PIR sensor HC-SR501) under the lid of the hooded litter box sees the cat’s body heat. An ESP8266 running ESPHome evaluates the signal: a visit starts with the first movement and ends after 150 seconds of stillness. Only visits lasting at least 10 seconds net are counted.
What hardware is inside?
A NodeMCU v2 (ESP8266) and an HC-SR501 PIR sensor, connected by three wires and powered by a USB power supply. Both sit in a 3D-printed PETG enclosure. The software: ESPHome on the microcontroller, Home Assistant as the hub and PocketBase as the database for this site.
How often does a cat use the litter box per day?
As a rule of thumb, a healthy adult cat urinates about two to four times a day, plus the number two. The sensor can’t tell the difference, it counts visits.
A sudden jump in visits, straining, crying or hardly any urine are reasons to see a vet. No urine at all is an emergency. For spotting changes like these, a litter box log is actually pretty handy.
What do Quick lick, Routine and Blockbuster mean?
The badges in the log depend on session length: Quick lick under 30 seconds, Routine up to 2 minutes, Blockbuster from 2 minutes. The longest session wears the crown 👑.
Why aren’t the times accurate to the minute?
Privacy, for cats too. The start time of each visit is rounded to 15 minutes for this site. The duration, however, is accurate to the second.
Does cleaning the litter box count?
No. Before scooping, a button starts maintenance mode: for 120 seconds the sensor ignores all movement, and a double click ends it early. A visit in progress is discarded.
Does the sensor bother the cat?
No. A PIR sensor emits nothing, it only measures the heat radiation Kalina gives off anyway. No camera, no microphone, no sound. The enclosure sits discreetly on the inside of the lid.
Can I write to Kalina?
Yes, fan mail, questions about building one yourself and treat offers are welcome. The email address is at the very bottom under “Contact”. Kalina herself doesn’t reply, but her staff does.
Can I build this myself?
Yes. You need a NodeMCU v2, an HC-SR501, three Dupont wires, a USB power supply and a 3D printer for the enclosure. The wiring diagram and the enclosure are shown above under “How It Works”. Experience with ESPHome and Home Assistant helps.