Skip to the content
4 layers50 × 36 mmNotifier v1, the printed circuit board in 3D

ESP32-C61 desk notifier: round GC9A01 display, BME688 air quality, clock, pushed pictures

Size
50 × 36 mm
Copper layers
4
Thickness
1.6 mm
Parts
46
Nets
52
Pads
182
Tracks, vias
506, 63
Pours
14
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
11 Oct 2026
Updated
31 Oct 2026

Overview

Notifier v1 is an open-source printed circuit board by tobiwan88, from the tobiwan88/desk_notifier repository on GitHub, published under the MIT licence. It is a 4-layer board of 50 × 36 mm with 46 parts on 52 nets, routed with 506 tracks and 63 vias.

It is built around the ESP32-S3-WROOM-1-N8R2, BME688 and SHT40-AD1B-R2, with the TLV62569DBV and USBLC6-2SC6 among its other parts. Its parts include 12 capacitors, 12 resistors, 5 ICs, 2 connectors and 1 diode. It belongs with the lEDs and displays and sensors and measurement boards and the ESP32 boards of this library.

Main components

5

README

README.md

Desk notifier

A small desk display on an ESP32-S3. A round 240x240 GC9A01 screen turns through three animated pages: a clock with today's forecast for Munich, a cute squirrel that shows the indoor air quality from a BME688 sensor, and the squirrel's day at home, which follows the clock (coffee in the morning, laptop, lunch, reading, sleep). When the air gets bad the squirrel stays on screen and asks you to open a window until you press a button.

The pages

It started as the esp_eyes project (animated eyes on two displays) and was cut down to one display. The git history keeps the old work.

What is in this repo

One repo holds the whole product: firmware, the custom board and the 3D-printed case.

PartWhereState
Firmware (ESP-IDF v6.1, C++23, host-tested core)firmware/, docs/Runs on the ESP32-S3 custom board (DESK_BOARD_NOTIFIER_V1) with a GC9A01, a BME688 and an SHT40; flashed and checked on a real board (sensors, display, Bluetooth setup).
Board notifier-v1 (KiCad 10, 4 layers, 50 x 36 mm, JLCPCB assembly)hardware/Generated, routed and gate-checked, fab package builds. Not ordered yet: human review in KiCad, JLC placement preview and the display pinout check are still open (ORDER.md).
Case (Fusion, 3D printed PLA, two parts, snap-fit)hardware/mechanics/First model with print files and a fit coupon. Never printed.
Helper tools (page previews, clip preparation)tools/, clipprep/Used by the checks.

Limitations

Please read these before building one.

  • ESP32-S3 only. The board uses an ESP32-S3-WROOM-1-N8R2, because C61 and C5 modules had no stock at JLCPCB. The earlier ESP32-C61 breadboard setup is no longer built or tested. The case is still untested (below).
  • The case is untested. No part of it has been printed. The display module has no 3D model, so the pocket, window and plug alignment rest on assumed dimensions (header 2.54 mm, pin row 3.0 mm above the PCB edge, glass centre 26.5 mm above it, PCB plus glass 5.74 mm). Print display_dummy.stl and coupon_m1.stl first and compare. The SHT40 height (1.0 mm) is also an assumption. The cover needs one support and the USB-C collar may sit about 0.7 mm short of the connector.
  • Display orientation is unconfirmed. The image is mirrored on X by default (DESK_LCD_MIRROR_X); flip it in menuconfig if your panel shows it backwards. The pin order of the display module on the board's socket is also still to be checked against a real module.
  • The air score is not BSEC. It is a simple estimate from humidity and gas resistance and needs a few minutes of warm-up. The sensor reads a little warm next to the board, so indoor temperature is slightly high.
  • No firmware security by default. The HTTP API, the pet page and OTA are open unless you set a token (auth token), the connection is plain HTTP, and the device is meant for a trusted home network. Do not expose it to the internet.
  • Weather and time need the internet (Open-Meteo, SNTP). Without it the clock stays unset and the weather items disappear. The place defaults to Munich (change it with POST /api/weather or weather at <lat> <lon>), holidays are Bavarian, and the texts are English.
  • Pictures are stored but not shown yet, there is one display, and the project is tuned to a single 240x240 round panel at 10 frames per second on a chip without an FPU.
  • The hardware generators overwrite KiCad edits. Change hardware/gen/*.py, not the KiCad files, then re-run the pipeline. The router needs tools that hardware/tools/setup_tools.sh downloads, and its result differs between runs.
  • Development on macOS. The scripts and notes assume macOS and a local ESP-IDF install in ~/esp/esp-idf.

What works today

  • Rotating pages with fades, 10 frames per second. See docs/pages.md.
    • Clock: time (set over the internet), date, indoor and outdoor temperature, today's low, high and chance of rain.
    • Air: a squirrel mascot whose mood shows the air level (very good, good, okay, bad), with temperature, humidity and score.
    • Day: the squirrel at its desk at home, doing what fits the time and weekday. The room's climate changes it (stuffy air: it yawns or opens the window; too warm, too cold, too dry, too humid; a sudden smell), so does the weather (umbrella, cocoa, thunder), and special days decorate the room (birthday, anniversary, Christmas, Advent, Halloween, Oktoberfest, ...). The real weather shows in the window, the real time on the wall clock. The scene is never random, but little things are: blinks, glances, a wave, a bird on the windowsill, a ladybug on the desk, a shooting star, a paper plane, a rare golden acorn. The moon shows its real phase, rainbows follow rain, a window-sill plant grows with good air day after day, and a wall calendar counts down to birthdays.
    • Pet page at http://<device>.local/pet: feed it, have a coffee break or a party together, pet it, play, water the plant, say good night, give it gifts. Daily visits grow a friendship (five heart levels, never lost) with more reactions and visitors, and squirrel coins for the shop (six things a day: hats, places, things for the room, friends, seasonal specials); the squirrel picks its own outfit.
  • Bad-air alert: the air page stays on, snoozed for 15 minutes by the button or by POST /api/ack. Without an alert the button shows the next page.
  • Web page at http://<device>.local/ and a small HTTP API.
  • Wi-Fi, over-the-air updates, and a serial console.
  • Picture upload (the clip format from esp_eyes) is stored but not shown yet.

Planned: pictures that stay on screen until acknowledged, Bosch BSEC2 for a proper IAQ value.

What you need

Dev setup (works today), or the custom board in hardware/ once it is built:

  • ESP32-S3 board with 8 MB flash and PSRAM (the notifier-v1 board, or an S3 dev board with the same pins)
  • GC9A01 round display, 240x240, SPI
  • BME688 breakout (I2C)
  • A push button (optional)
  • USB cable

The squirrel

The squirrel's mood follows the indoor air quality. What it wears follows the weather outside (Open-Meteo, Munich by default):

OutsideSquirrel
below 8 °Cknitted hat and scarf
25 °C or moreice cream
sunny, daytimesunglasses
drizzle, rain, thunderumbrella
wind of 30 km/h or moreglides under the umbrella, tail streaming

Items stack (cold, rainy and windy gives hat, umbrella and gliding). Preview every look on your computer with uv run python tools/preview_pages.py out/ after scripts/check.sh --quick.

Wiring

SignalGPIONote
Display SCL / SDA6 / 5
Display DC / RST / CS3 / 2 / 4
Display VCC / GND5V / GND
BME688 SDA / SCL22 / 233V3, not 5V. Address 0x77 or 0x76, both are tried
Button24other leg to GND

Details: docs/wiring.md. Pins can be changed in idf.py menuconfig under "Desk notifier". If the picture is mirrored, flip DESK_LCD_MIRROR_X / DESK_LCD_MIRROR_Y there.

Build and flash

You need ESP-IDF v6.1 and uv.

sh
source scripts/idf-env.sh
cd firmware
idf.py -p /dev/cu.usbserial-XXXX flash monitor

Connect to Wi-Fi

Open the serial console and run wifi "<name>" <password>. The device reboots and joins your network. It is then reachable as desk-<last 6 MAC digits>.local. The timezone is set in menuconfig (DESK_TZ, default Central Europe).

API

By default the API needs no password (change with the console command auth token).

sh
curl http://desk-xxxxxx.local/api/sensor     # temperature, humidity, pressure, gas, score
curl http://desk-xxxxxx.local/api/status     # uptime, memory, Wi-Fi, sensor state
curl -X POST http://desk-xxxxxx.local/api/ack   # snooze the alert
curl http://desk-xxxxxx.local/api/weather    # the last forecast
curl -X POST http://desk-xxxxxx.local/api/page -d '{"page":"day"}'   # clock, air, day or next ("weather" still works)
curl -X POST http://desk-xxxxxx.local/api/weather -d '{"lat":48.137,"lon":11.575,"place":"Munich"}'   # change the place
curl -X POST --data-binary @firmware.bin http://desk-xxxxxx.local/api/ota

Console commands

wifi, status, sensor, ack, page clock|air|day|next, weather [refresh | at <lat> <lon> [name]], lcd pins, lcd init [hz], hostname, auth open|token, token, reboot, factory-reset.

About the air-quality score

It is a simple estimate, not Bosch BSEC. 25 points come from humidity (best at 40 %) and 75 from the gas resistance compared with the highest value seen recently. It needs about 3 minutes to warm up and a stretch of clean air to be meaningful. The sensor also reads a little warm because it sits next to the board.

For developers

scripts/check.sh runs the host tests (C++23, sanitizers), the Python tests and the firmware build. --quick skips the build. uv run python tools/preview_pages.py draws all pages as GIFs on your computer (after a host build). Pure logic lives in firmware/components/*/core and is tested on the PC. See CLAUDE.md for the layout.

Hardware and case

  • Board: open hardware/notifier-v1/notifier-v1.kicad_pro with hardware/open.sh. Regenerate with hardware/tools/pipeline_v1.sh, check with scripts/hw-check.sh, order steps in hardware/notifier-v1/ORDER.md, design notes in hardware/PLAN.md. Needs KiCad 10 (source scripts/kicad-env.sh).
  • Case: print files and notes in hardware/mechanics/ (PLA, 0.2 mm layers, Bambu Lab plate included). Print the fit coupon first.
  • Firmware: idf.py build in firmware/ (target ESP32-S3). Wi-Fi, time zone and name can be set from a phone over Bluetooth: setup/.

License

MIT. The BME68x driver in firmware/components/sensor/third_party is from Bosch Sensortec (BSD-3-Clause).

Parts

46
QtyValueFootprintReferences
5100nCapacitor_SMD:C_0402_1005MetricC3, C6, C7, C8, C9
4M2MountingHole:MountingHole_2.2mm_M2H1, H2, H3, H4
322uCapacitor_SMD:C_0805_2012MetricC2, C5, C11
34.7kResistor_SMD:R_0402_1005MetricR3, R7, R8
210kResistor_SMD:R_0402_1005MetricR4, R5
21uCapacitor_SMD:C_0402_1005MetricC4, C10
222Resistor_SMD:R_0402_1005MetricR11, R12
25.1kResistor_SMD:R_0402_1005MetricR1, R2
1100kResistor_SMD:R_0402_1005MetricR9
110uCapacitor_SMD:C_0603_1608MetricC1
12.2uInductor_SMD:L_Cenker_CKCS4030L1
122kResistor_SMD:R_0402_1005MetricR10
133Resistor_SMD:R_0402_1005MetricR13
13V3TestPoint:TestPoint_Pad_D1.5mmTP4
14.7uCapacitor_SMD:C_0603_1608MetricC12
1500mAFuse:Fuse_1206_3216MetricF1
1BME688Package_LGA:Bosch_LGA-8_3x3mm_P0.8mm_ClockwisePinNumberingU4
1ENTestPoint:TestPoint_Pad_D1.5mmTP5
1ESP32-S3-WROOM-1-N8R2RF_Module:ESP32-S3-WROOM-1U1
1GC9A01 DISPLAYConnector_PinSocket_2.54mm:PinSocket_1x07_P2.54mm_HorizontalJ2
1GNDTestPoint:TestPoint_Pad_D1.5mmTP3
1IO0TestPoint:TestPoint_Pad_D1.5mmTP6
1LCD_VCCJumper:SolderJumper-3_P1.3mm_Bridged12_RoundedPad1.0x1.5mmJP1
1RXD0TestPoint:TestPoint_Pad_D1.5mmTP2
1SHT40-AD1BSensor_Humidity:Sensirion_DFN-4_1.5x1.5mm_P0.8mm_SHT4x_NoCentralPadU5
1TLV62569Package_TO_SOT_SMD:SOT-23-5U3
1TXD0TestPoint:TestPoint_Pad_D1.5mmTP1
1USB-C PWR/DATAConnector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12J1
1USBLC6-2SC6Package_TO_SOT_SMD:SOT-23-6U2
1VBUSTestPoint:TestPoint_Pad_D1.0mmTP7
1redLED_SMD:LED_0603_1608MetricD1

Similar boards

  • 2 layers41.5 × 35 mmDesk dashboard, the printed circuit board in 3D

    Desk dashboard

    rspolyak/desk-dashboard-hw

    ESP32-S3 desk dashboard board that plugs straight into a 3.5" MSP3526 capacitive touch display. USB-C powered, with a light sensor, SHT40 temperature/humidity sensor and a 41.5 × 35 mm 2-layer PCB

    36 parts9MIT
  • 4 layers119 × 79 mmLuxdmx, the printed circuit board in 3D

    Luxdmx

    tombueng/LuxDMX

    Open-source Art-Net / sACN (E1.31) → DMX512 gateway for ESP32 / ESP32-S3 / Ethernet. Live web UI shows all 512 channels in real time, flags console conflicts, and drives galvanically-isolated DMX.

    97 parts97
  • 4 layers66 × 36 mmGas sensor, the printed circuit board in 3D

    Gas sensor

    JamesTwallin/gas_sensor

    A tiny plug-in board for the rev E phone-companion board. It stands upright in a notch in rev E's sensor end, between the two gas sensor cans, and pokes 4.5 mm out through a slot in the case face, so its tip sits in the…

    81 parts7MIT
  • 4 layers112 × 75 mmKvm board, the printed circuit board in 3D

    Kvm board

    FuNK3Y/picoKVM

    A network KVM that can switch inputs of smart monitors

    95 parts6
  • 2 layers96 × 50 mmPager, the printed circuit board in 3D

    Pager

    justinlindh/bramble

    Privacy-first LoRa mesh networking for ESP32-S3, built with ESP-IDF

    97 parts2MIT
  • 2 layers36 × 72 mmHCP Bridge, the printed circuit board in 3D

    HCP Bridge

    JonasE99/HCP-Bridge

    🚧 WIP – not yet manufactured or tested. KiCad PCB (one per door) connecting Hörmann series 4 garage door operators (ProMatic/SupraMatic, BUS/RJ12) to Loxone via ESP32-S3 and Wi-Fi.

    53 parts1
  • 2 layers50 × 40 mmEsp32c3-sensor node, the printed circuit board in 3D

    Esp32c3-sensor node

    Alexden28/esp32c3-sensor-node-pcb

    2-layer ESP32-C3 + SHT40 USB-C sensor node in KiCad 10, generated from Python, autorouted, ERC/DRC clean, with Gerbers/BOM/CPL/STEP

    28 partsMIT
  • 2 layers64 × 46 mmWeatherframe, the printed circuit board in 3D

    Weatherframe

    amselgesang/weatherframe_v01

    My weather station hardver

    50 partsMIT

Questions

How big is the Notifier v1 PCB?

It measures 50 × 36 mm and has 4 copper layers, 1.6 mm thick.

What parts does the Notifier v1 use?

46 parts, built around the ESP32-S3-WROOM-1-N8R2, BME688, SHT40-AD1B-R2 and TLV62569DBV. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Notifier v1 KiCad files?

From the tobiwan88/desk_notifier repository on GitHub, at the commit this page was made from: the board is hardware/notifier-v1/notifier-v1.kicad_pcb and its schematic hardware/notifier-v1/display.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Notifier v1 design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).