gitwtfhub

wtf is esp32cyd-kitchen-timer?

peggleg/esp32cyd-kitchen-timer — explained in plain English

Analysis updated 2026-05-18

0Audience · ops devopsComplexity · 3/5Setup · moderate

TL;DR

An ESPHome-based touchscreen kitchen timer with Home Assistant integration, preset buttons, and Sonos alarm automation.

Mindmap

mindmap
  root((repo))
    What it does
      Touchscreen timer
      Preset time buttons
      Alarm with auto silence
      Home Assistant entities
    Tech stack
      ESPHome
      ESP32
      LVGL
    Use cases
      Kitchen cooking timer
      Sonos alarm automation
    Audience
      Home Assistant users
      Hobbyist makers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run a touchscreen kitchen timer with preset and custom time entry.

REASON 2

Control and monitor the timer remotely through Home Assistant entities.

REASON 3

Trigger a Sonos speaker alarm automation when the timer ends.

REASON 4

Customize preset buttons, colors, and touchscreen calibration for your own display.

What's in the stack?

ESPHomeESP32LVGLYAML

How it stacks up

peggleg/esp32cyd-kitchen-timer00kaku/gallery-slider-block04amanrajj/netwatch
Stars00
LanguageJavaScriptRust
Last pushed2021-05-19
MaintenanceDormant
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audienceops devopsgeneralops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires an ESP32-2432S028 CYD device, WiFi credentials, and ESPHome flashing tools.

Wtf does this do

This project is a kitchen timer built on a small touchscreen device called the ESP32 2432S028, sometimes nicknamed the Cheap Yellow Display, running an open source home automation firmware system called ESPHome. It integrates directly with Home Assistant, the smart home platform, so the timer can be watched and controlled from your existing smart home setup as well as from the device itself. On the touchscreen you get quick preset buttons for adding 1 minute, 10 minutes, 30 minutes, or 1 hour, plus a keypad for entering a custom time in seconds, minutes, or hours, up to a maximum of 12 hours. You can pause and resume the timer, add extra time while it is already running, and watch a progress bar count down. When time runs out, the screen flashes and an alarm sounds, automatically going quiet after 10 minutes if nobody responds. The README also includes an example Home Assistant automation that plays a sound through a Sonos speaker when the timer ends, pausing whatever was already playing and restoring it afterward. Through Home Assistant, the timer exposes several controls and sensors: how many seconds remain, whether the alarm is active, whether the timer is running, a way to set the duration directly, and a switch to start or pause it. The display itself is 320 by 240 pixels, rotated sideways, using a bold Roboto font and a warm cream and teal color scheme, built with a graphics library called LVGL. Setting it up means adding your WiFi network name and password along with a few generated keys to a secrets file, then flashing the device using ESPHome's tools. If it cannot reach your WiFi, it creates its own temporary WiFi network so you can reconnect it. The project also documents how to customize preset button values, screen colors, the maximum timer duration, and touchscreen calibration values directly in the configuration.

Yoink these prompts

Prompt 1
Walk me through setting up secrets.yaml and flashing this to my ESP32-2432S028 with ESPHome.
Prompt 2
Show me how to add the Sonos alarm automation to my Home Assistant setup.
Prompt 3
Explain how to customize the preset button durations and screen colors.
Prompt 4
Help me calibrate the touchscreen using the calibration values in the config.

Frequently asked questions

wtf is esp32cyd-kitchen-timer?

An ESPHome-based touchscreen kitchen timer with Home Assistant integration, preset buttons, and Sonos alarm automation.

How hard is esp32cyd-kitchen-timer to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is esp32cyd-kitchen-timer for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.