
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

ESP32-C61 desk notifier: round GC9A01 display, BME688 air quality, clock, pushed pictures
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.
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.

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.
One repo holds the whole product: firmware, the custom board and the 3D-printed case.
| Part | Where | State |
|---|---|---|
| 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. |
Please read these before building one.
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.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.auth token), the connection is plain HTTP, and the device is meant for a trusted home network. Do not expose it to the internet.POST /api/weather or weather at <lat> <lon>), holidays are Bavarian, and the texts are English.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.~/esp/esp-idf.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.POST /api/ack. Without an alert the button shows the next page.http://<device>.local/ and a small HTTP API.Planned: pictures that stay on screen until acknowledged, Bosch BSEC2 for a proper IAQ value.
Dev setup (works today), or the custom board in hardware/ once it is built:
The squirrel's mood follows the indoor air quality. What it wears follows the weather outside (Open-Meteo, Munich by default):
| Outside | Squirrel |
|---|---|
| below 8 °C | knitted hat and scarf |
| 25 °C or more | ice cream |
| sunny, daytime | sunglasses |
| drizzle, rain, thunder | umbrella |
| wind of 30 km/h or more | glides 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.
| Signal | GPIO | Note |
|---|---|---|
| Display SCL / SDA | 6 / 5 | |
| Display DC / RST / CS | 3 / 2 / 4 | |
| Display VCC / GND | 5V / GND | |
| BME688 SDA / SCL | 22 / 23 | 3V3, not 5V. Address 0x77 or 0x76, both are tried |
| Button | 24 | other 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.
You need ESP-IDF v6.1 and uv.
source scripts/idf-env.sh
cd firmware
idf.py -p /dev/cu.usbserial-XXXX flash monitorOpen 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).
By default the API needs no password (change with the console command auth token).
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/otawifi, 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.
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.
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/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).hardware/mechanics/ (PLA, 0.2 mm layers, Bambu Lab plate included). Print the fit coupon first.idf.py build in firmware/ (target ESP32-S3). Wi-Fi, time zone and name can be set from a phone over Bluetooth: setup/.MIT. The BME68x driver in firmware/components/sensor/third_party is from Bosch Sensortec (BSD-3-Clause).
| Qty | Value | Footprint | References |
|---|---|---|---|
| 5 | 100n | Capacitor_SMD:C_0402_1005Metric | C3, C6, C7, C8, C9 |
| 4 | M2 | MountingHole:MountingHole_2.2mm_M2 | H1, H2, H3, H4 |
| 3 | 22u | Capacitor_SMD:C_0805_2012Metric | C2, C5, C11 |
| 3 | 4.7k | Resistor_SMD:R_0402_1005Metric | R3, R7, R8 |
| 2 | 10k | Resistor_SMD:R_0402_1005Metric | R4, R5 |
| 2 | 1u | Capacitor_SMD:C_0402_1005Metric | C4, C10 |
| 2 | 22 | Resistor_SMD:R_0402_1005Metric | R11, R12 |
| 2 | 5.1k | Resistor_SMD:R_0402_1005Metric | R1, R2 |
| 1 | 100k | Resistor_SMD:R_0402_1005Metric | R9 |
| 1 | 10u | Capacitor_SMD:C_0603_1608Metric | C1 |
| 1 | 2.2u | Inductor_SMD:L_Cenker_CKCS4030 | L1 |
| 1 | 22k | Resistor_SMD:R_0402_1005Metric | R10 |
| 1 | 33 | Resistor_SMD:R_0402_1005Metric | R13 |
| 1 | 3V3 | TestPoint:TestPoint_Pad_D1.5mm | TP4 |
| 1 | 4.7u | Capacitor_SMD:C_0603_1608Metric | C12 |
| 1 | 500mA | Fuse:Fuse_1206_3216Metric | F1 |
| 1 | BME688 | Package_LGA:Bosch_LGA-8_3x3mm_P0.8mm_ClockwisePinNumbering | U4 |
| 1 | EN | TestPoint:TestPoint_Pad_D1.5mm | TP5 |
| 1 | ESP32-S3-WROOM-1-N8R2 | RF_Module:ESP32-S3-WROOM-1 | U1 |
| 1 | GC9A01 DISPLAY | Connector_PinSocket_2.54mm:PinSocket_1x07_P2.54mm_Horizontal | J2 |
| 1 | GND | TestPoint:TestPoint_Pad_D1.5mm | TP3 |
| 1 | IO0 | TestPoint:TestPoint_Pad_D1.5mm | TP6 |
| 1 | LCD_VCC | Jumper:SolderJumper-3_P1.3mm_Bridged12_RoundedPad1.0x1.5mm | JP1 |
| 1 | RXD0 | TestPoint:TestPoint_Pad_D1.5mm | TP2 |
| 1 | SHT40-AD1B | Sensor_Humidity:Sensirion_DFN-4_1.5x1.5mm_P0.8mm_SHT4x_NoCentralPad | U5 |
| 1 | TLV62569 | Package_TO_SOT_SMD:SOT-23-5 | U3 |
| 1 | TXD0 | TestPoint:TestPoint_Pad_D1.5mm | TP1 |
| 1 | USB-C PWR/DATA | Connector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12 | J1 |
| 1 | USBLC6-2SC6 | Package_TO_SOT_SMD:SOT-23-6 | U2 |
| 1 | VBUS | TestPoint:TestPoint_Pad_D1.0mm | TP7 |
| 1 | red | LED_SMD:LED_0603_1608Metric | D1 |

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

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.

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…


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

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.

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

It measures 50 × 36 mm and has 4 copper layers, 1.6 mm thick.
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.
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.
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).