Deutsch
🐾 LIVE FROM THE LITTER

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.

Status right now
…
Connecting to the litter box …
Visits today
–
 
Record session
–
 
Ø session length
–
 
Visits all time
–
since the sensor went live

Meow Facts purr-ocessed automatically

⏱ Total time in the box
–
 
🏜 Longest dry spell
–
 
🔥 Streak
–
 
⭐ Favourite hour
–
 
🐾 Cat fact of the day

Cats sleep 12 to 16 hours a day on average.

Rush Hour

Visits by time of day, last 30 days
00:0006:0012:0018:00

Kalina’s Commit History

One paw per day, last 12 weeks
MonWedFriSun
less more

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

Kalina is sorting the files …

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.

  • #Cat
  • #BritishShorthair
  • #BritishBlue
  • #CatsOfInstagram
  • #CatLife
  • #CatLover
  • #HouseCat
  • #PedigreeCat
  • #LitterBox
  • #CatHumor
  • #CatContent
  • #FluffyButt
  • #Purr
  • #Meow

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.

  1. PIR sensorHC-SR501 senses Kalina’s body heat
  2. ESP8266ESPHome handles hold time and minimum duration
  3. Home Assistantsends push quips and reports every visit
  4. PocketBasestores the log and live status
  5. This sitelistens in live via realtime
Wiring diagram: HC-SR501 PIR sensor to NodeMCU v2 (ESP8266)Three wires: plus of the HC-SR501 to Vin of the NodeMCU (5 volts from USB), OUT to D5 (GPIO14), minus to the GND right next to Vin. The NodeMCU is powered via micro-USB from a 5 volt supply with at least 1 ampere.+OUT−HC-SR501PIR motion sensorJumper set to HTime pot fully left(ESPHome handlesthe hold time)ESP8266ESP-12ENodeMCUv2 · AmicaA0RSVRSVSD3SD2SD1CMDSD0CLKGND3V3ENRSTGNDVinD0D1D2D3D43V3GNDD5D6D7D8RXTXGND3V3OUT → D5 (GPIO14)− → GND+ → Vin (5 V)USB power supply5 V · ≥ 1 A
Three wires, one jump: the yellow signal wire hops over ground.

Wiring

HC-SR501NodeMCU v2Why
+ (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.
OUTD5 (GPIO14)Outputs 3.3 V, connects directly. Not a boot pin, and D1/D2 stay free for I²C.
− (GND)GNDThe 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

  1. After power-up, the PIR warms up for 60 s.
  2. The first movement starts a visit; after 150 s of stillness it’s over.
  3. “Occupied” only shows after 10 s in the box – a quick peek doesn’t count.
  4. Session length is net: occupied time minus hold time.
  5. When cleaning, a button switches on maintenance mode: nothing counts for 120 s, a double click ends it early.

The 3D-printed enclosure

Exploded view of the enclosure: the light top part with screw bosses above, the yellow bottom part with NodeMCU and PIR sensor below
Exploded view: the light top part sticks to the inside of the lid, the yellow bottom part holds the electronics.
The closed enclosure from below: the PIR sensor’s lens dome, three countersunk screw holes and the side opening for the micro-USB plug
From below: only the lens dome looks into the box. The micro-USB plugs in from the side.
  • 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.
  • #ESPHome
  • #HomeAssistant
  • #ESP8266
  • #NodeMCU
  • #HCSR501
  • #PIRSensor
  • #PocketBase
  • #SmartHome
  • #3DPrinting
  • #PETG
  • #OpenSCAD
  • #DIY

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.