After Dark / ESPHome

Put the After Dark screen savers on an ESP32 with a little screen, and pick one from Home Assistant. Switch on the modules you want, check they fit the flash, and copy the program into ESPHome. Only the modules you switch on go into the firmware.

MODEL AD-ESP · REV v1.3.1
MODULES — · BUS I²C / SPI
RUNFLASH FULL

01CPU and display

02Saver modules

Each AD module is ported from its page on the After Dark site. On a 1-bit OLED its art is shrunk and redrawn in black and white; on a character LCD it is drawn with the panel's eight custom characters. The EX module is an extra from outside After Dark: Dolphins, drawn for this in the style of the cyan OEL car stereos. Point at a module's screen to see it run on the display you chose. Hatched modules have no version for this display.

For the stereos' own clips (the dolphins, the colour movies, the level meters) see the sister project, OEL for ESPHome.

04Flash load

05Program

Pins are examples: change them to match your wiring. Wi-Fi comes from your secrets.yaml.

06Install with Vome

If your Home Assistant is connected to Vome, your AI assistant (Claude, Cursor, or any app that talks MCP) can put this on the board for you. It adds the config to ESPHome Device Builder, builds the firmware and installs it, and you approve each step.

  1. Add the Vome app to Home Assistant and make a key on its Agent tab, as Vome's ESPHome guide shows. Home Assistant needs the ESPHome Device Builder app too.
  2. For a new board, plug it into the machine running Home Assistant by USB. After the first install, updates go over Wi-Fi.
  3. Copy the request and paste it to your assistant.
The request carries the program above, so set up the board and display first.