gitwtfhub

wtf is esp32-s3-touch-amoled-codexpedometer?

doublemarkpro/esp32-s3-touch-amoled-codexpedometer — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 4/5Setup · hard

TL;DR

A smartwatch style firmware demo for a round AMOLED ESP32-S3 dev board that also shows Codex usage and AI coding agent status.

Mindmap

mindmap
  root((repo))
    What it does
      Smartwatch UI demo
      Shows AI agent status
    Tech stack
      ESP32-S3
      ESP-IDF
      Python helper scripts
    Features
      Pedometer
      Weather page
      Codex quota bridge
    Use cases
      Desktop status display
      Monitor AI coding tools
    Audience
      Hardware hobbyists
      Codex and Claude Code users

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

Flash a small round touchscreen board to show a smartwatch style clock, weather, and step counter as a desktop gadget.

REASON 2

Monitor OpenAI Codex usage quota and AI coding agent status like idle, working, or error directly on a physical display.

REASON 3

Run the included Python bridge scripts on a Windows PC to feed Codex and Claude Code hook events to the device.

What's in the stack?

ESP32-S3ESP-IDFPythonC

How it stacks up

doublemarkpro/esp32-s3-touch-amoled-codexpedometer0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultyhardhardhard
Complexity4/54/54/5
Audiencedeveloperdeveloperresearcher

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

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires the ESP-IDF toolchain, flashing firmware over serial, and running separate Python helper scripts on a PC for full functionality.

Wtf does this do

This repository is built on top of Waveshare's official ESP32-S3-Touch-AMOLED-1.75 development board project, a small circuit board that combines an ESP32-S3 chip with a 1.75 inch round AMOLED touchscreen, touch sensing, motion sensing, a real time clock, audio hardware, and storage support. The repository keeps all of the original examples, schematics, and firmware notes from the board maker, and adds one new example project called CodexPedometer. CodexPedometer turns the round touchscreen board into a small desktop smartwatch style status display. It includes a clock face with an optional simulated hand and time synced over the network, a weather page pulled from a Chinese mapping web service, a pedometer page that uses the board's built in six axis motion sensor to show step count, distance, and estimated calories, and two status pages built specifically for AI coding tools: one shows how much usage quota is left on OpenAI's Codex tool, and another shows whether an AI coding agent such as Codex or Claude Code is currently idle, working, waiting, in an error state, or finished with a task. On first boot the device creates its own Wi-Fi hotspot with a simple web page for entering your home Wi-Fi details, weather city, and the addresses of two small helper programs that run on your computer. Those two helper programs are Python scripts you run on a Windows PC: one reads real Codex usage data from the Codex desktop app and serves it over a local web address, and the other tracks and serves AI agent status, with an option to install itself so it starts automatically when you log into Windows. A Codex hook script and a printable Claude Code hook configuration let those tools report their current state to this status server, which the watch then displays. Getting the CodexPedometer demo running requires the ESP-IDF development toolchain, version 6.0.2 or newer, setting the build target to esp32s3, then building and flashing the firmware to the board over a serial port. The README explicitly warns not to commit personal Wi-Fi passwords, API keys, or private network addresses, since the repository's own default configuration values are placeholders.

Yoink these prompts

Prompt 1
Walk me through flashing the CodexPedometer example onto the ESP32-S3-Touch-AMOLED-1.75 board using ESP-IDF.
Prompt 2
Explain how the Codex usage bridge and AI agent status bridge Python scripts work with this device.
Prompt 3
Show me how to connect to the board's setup Wi-Fi hotspot and configure my home network and weather city.
Prompt 4
Describe how to print and install the Claude Code hook configuration this project generates.

Frequently asked questions

wtf is esp32-s3-touch-amoled-codexpedometer?

A smartwatch style firmware demo for a round AMOLED ESP32-S3 dev board that also shows Codex usage and AI coding agent status.

What language is esp32-s3-touch-amoled-codexpedometer written in?

Mainly Python. The stack also includes ESP32-S3, ESP-IDF, Python.

How hard is esp32-s3-touch-amoled-codexpedometer to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is esp32-s3-touch-amoled-codexpedometer for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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