ESP32 Notifier for Home Assistant – Wi-Fi audio notifier / speaker with web UI, MQTT and OTA

Hi everyone,

I’d like to share my ESP32-based Home Assistant notifier project:

GitHub:

This is a custom PlatformIO firmware project for an ESP32-based Wi-Fi audio notifier / speaker for Home Assistant.

Main features:

  • local web UI with separate HTML, CSS, and JavaScript assets
  • Wi-Fi station mode with fallback AP configuration mode
  • MQTT command and state bridge for Home Assistant
  • I2S audio output for MP3 streams, radio streams, and URL-based TTS playback
  • OTA update support from GitHub release or manifest URL
  • battery voltage monitoring
  • OLED status display support
  • saved settings in Preferences / NVS

Current documented hardware is based on:

  • ESP32-S3 Super Mini
  • PCM5102 I2S DAC
  • 0.96" I2C OLED
  • two TTP223 touch sensors
  • buzzer

The project also includes:

  • hardware documentation
  • circuit diagram
  • STL files for the enclosure
  • a dedicated firmware profile for Home Assistant media-player use with bkbilly/mqtt_media_player

This project is not ESPHome — it is a custom modular PlatformIO firmware intended to be buildable and extendable.

I’d be very happy to get feedback, suggestions, and ideas for improvement.

Thanks!