Icon of ESPHome app on Umbrel App Store

ESPHome

Intelligently manage all your ESP8266/ESP32 devices

ESPHome

Open App Store on your umbrelOS device to install this app
Screenshot 1 of ESPHome app on Umbrel App Store
Screenshot 2 of ESPHome app on Umbrel App Store
Screenshot 3 of ESPHome app on Umbrel App Store
About this app

ESPHome is a system to control your ESP8266/ESP32 by simple yet powerful configuration files and control them remotely through Home Automation systems.

What's new
Version 2025.10.51 day ago

This release includes several improvements and fixes:

  • Fixed USB UART transfer queue allocation issues
  • Improved LVGL display rotation handling for unusual widths
  • Added support for configuring display rows
  • Python 3.14 compatibility restrictions

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.10.46 days ago

This release includes several improvements and fixes:

  • Fixed UART initialization and pin configuration issues
  • Improved LVGL automation handling and binary sensor events
  • Enhanced display rotation support for custom models
  • Better error reporting for image loading
  • Fixed keyboard mappings for SDL

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.10.33 weeks ago

This release includes several improvements and fixes:

  • Enhanced MIPI SPI display rotation support
  • Improved handling of OTA updates and passwords
  • Fixed enterprise WiFi connectivity issues
  • Resolved issues with packages using substitutions
  • Improved datetime and ESP32 functionality
  • Fixed temperature offset handling for certain sensors
  • Enhanced UART pin configuration options

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.10.1this month

This release includes several improvements:

  • Fixed MQTT resolution for OTA updates when using static IP
  • Improved handling of blank OTA passwords
  • Fixed enterprise WiFi connectivity issues
  • Resolved issues with packages using substitutions
  • Enhanced MIPI SPI display rotation support

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.10.0this month

This release includes several new features and improvements:

  • New components: Z-Wave proxy, WTS01 temperature sensor, SHA256 support, LM75B temperature sensor, and SPI e-paper display
  • Enhanced ESP32 features including Arduino as an IDF component and multiple CAN instances support
  • Improved BLE and Ethernet functionality
  • Added external wake word support for voice assistants
  • Optimized memory usage and performance across various components
  • Improved API security and connection handling

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.9.3last month

This release includes several improvements and bug fixes:

  • Improved API security for noise encryption keys
  • Fixed issues with incoming call handling for SIM800L
  • Enhanced voice assistant functionality
  • Optimized ESP32 Improv provisioning
  • Improved support for various displays and hardware
  • Fixed MQTT logging and packet transport issues

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.9.1last month

This release includes several improvements and new features:

  • Added support for querying light effects by index
  • Introduced a unified driver for MIPI RGB displays
  • Added JPEG encoder support for cameras
  • Improved Bluetooth proxy functionality
  • Enhanced timezone support for automatic synchronization
  • Optimized memory usage and performance across various components
  • Fixed issues with MQTT logging and packet transport
  • Improved ESP8266 mDNS compilation

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.9.0last month

This release includes several improvements and new features:

  • Added support for querying light effects by index
  • Introduced a unified driver for MIPI RGB displays
  • Added JPEG encoder support for cameras
  • Improved Bluetooth proxy functionality
  • Enhanced timezone support for automatic synchronization
  • Optimized memory usage and performance across various components
  • Added support for new sensors and expanded configuration options

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.8.4last month

This release includes several improvements and bug fixes:

  • Improved WiFi reconnection after adapter restart
  • Fixed display dimensions and configurations
  • Optimized I2C operations and register reads
  • Enhanced WiFi retry mechanisms
  • Improved OTA update process and stability
  • Enhanced RTTTL playback for speakers
  • Optimized watchdog resets
  • Fixed various sensor and component issues

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.8.22 months ago

This release includes several improvements and bug fixes:

  • Improved WiFi reconnection after adapter restart
  • Fixed MIPI SPI display dimensions
  • Optimized I2C register reads
  • Enhanced WiFi retry for hidden networks
  • Fixed OTA uploads to offline OpenThread devices
  • Improved RTTTL playback for speakers
  • Optimized OTA watchdog resets
  • Enhanced BLE connection parameters
  • Fixed parallel mode scripts with delays
  • Improved error reporting and logging

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.8.02 months ago

This release includes several improvements and new features:

  • New ESP32 ADC and PSRAM execution options
  • Enhanced LVGL color handling and tileview functionality
  • Improved OTA progress updates and WiFi connection management
  • New components for ESP-NOW communication and LD2412 sensor
  • Added support for CO5300 displays
  • Expanded automation capabilities for switches and remote transmitters
  • Optimized Bluetooth proxy and ESP32 BLE functionality
  • Improved sensor filtering options
  • Enhanced logging and error reporting

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.7.53 months ago

This release includes several improvements and bug fixes:

  • Enhanced LVGL tileview functionality
  • Improved OTA progress updates
  • Better font file handling
  • Upgraded audio processing for I2S
  • Refined remote receiver idle validation
  • Enhanced GT911 I2C communication
  • Improved LD2450 target calculation
  • Updated logger configuration requirements
  • Optimized setup process

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.7.43 months ago

This release includes several improvements and bug fixes:

  • Enhanced GPIO pin management for binary sensors
  • Improved display rendering for SDL and MIPI SPI
  • Updated ESP32 touch driver functionality
  • Refined fan schema usage in Tuya component
  • Added support for suggesting alternate components or platforms
  • Optimized core processing during setup phase
  • Improved compatibility with various components

⚠️ This version may include breaking changes that could require updates to your configurations.

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.7.33 months ago

This release includes several improvements and bug fixes:

  • Enhanced GPIO pin management for binary sensors
  • Improved display rendering for SDL and MIPI SPI
  • Updated ESP32 touch driver functionality
  • Refined fan schema usage in Tuya component
  • Added support for suggesting alternate components or platforms
  • Optimized core processing during setup phase
  • Improved compatibility with IDF for various components

⚠️ This version may include breaking changes that could require updates to your configurations.

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.7.23 months ago

This release includes several bug fixes and improvements:

  • Fixed template event web_server crash
  • Resolved compilation errors with char* lambdas in HomeAssistant services
  • Fixed boot loop issue with WireGuard when certain configurations are enabled
  • Corrected cancellation of timers with empty string names
  • Improved logger functionality
  • Enhanced scheduler behavior for DelayAction cancellation
  • Fixed LVGL meter rotation
  • Resolved issues with LibreTiny platforms
  • Improved media player pipeline state tracking
  • Enhanced voice assistant TTS response status tracking

⚠️ This version includes breaking changes that may require updates to your configurations.

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.7.03 months ago

This release includes several new components, breaking changes, and notable improvements.

Key highlights:

  • Added support for new components like Xiaomi XMWSDJ04MMC, OPT3001, and LN882X Family
  • Introduced Jinja expressions in configs for more flexibility
  • Optimized memory usage and performance in various components
  • Improved API and Bluetooth proxy functionality
  • Updated ArduinoJson library to version 7.4.2

⚠️ This version includes breaking changes that may require updates to your configurations.

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.6.34 months ago

This release includes several bug fixes and improvements to enhance stability and performance.

Key updates in this release include:

  • Fixed issues with UART configuration and API log client
  • Improved HTTP request handling and LVGL QR code display
  • Enhanced audio timeout handling and voice assistant support
  • Updated MDNS query settings for ESP32
  • Improved pin interrupt handling for MCP23XXX devices

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.6.24 months ago

This release includes several bug fixes and improvements to enhance stability and performance.

Key updates in this release include:

  • Fixed issues with LVGL qrcode and audio handling
  • Improved timeout handling for audio components
  • Enhanced voice assistant support for streaming TTS responses
  • Changed default MDNS query settings for ESP32
  • Fixed pin interrupts for MCP23XXX devices
  • Disabled I2C scan on certain IDF versions

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.6.14 months ago

This release includes several bug fixes and improvements to enhance stability and performance.

Key updates in this release include:

  • Fixed memory fragmentation issues with Bluetooth event handling
  • Improved Nextion display command spacing and response handling
  • Enhanced Bluetooth scanning reliability and RSSI sensor functionality
  • Better network address validation
  • Restored access to Bluetooth scan results for custom components

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.6.04 months ago

⚠️ This release includes breaking changes. Please check that your configurations are still working correctly after updating.

Key updates in this release include:

  • New components: CUBIC CM1106 CO2 sensor, USB Host UART, ES8388 audio DAC, LC709203F battery monitor, ESP32-P4 LDO support, and OpenThread support
  • Memory optimizations to reduce flash usage and improve performance
  • Enhanced BLE handling with lock-free queues to prevent drops
  • Improved API message batching system
  • Better GPIO interrupt handling for RP2040 and ESP8266
  • Fixed fan speed initialization and logger stack overflow issues

Breaking changes:

  • Minimum Python version updated to 3.10
  • Various memory optimizations that may affect custom components
  • LWIP optimization options to reduce flash usage

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.5.25 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

Key updates in this release include:

  • Improved mic task handling to avoid core pinning
  • Enhanced GPIO interrupt handling for RP2040 and ESP8266
  • Made debug sensors work without requiring verbose logging
  • Fixed potential logger stack overflow issue

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.5.15 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

Key updates in this release include:

  • Improved error messages for text validation in LVGL
  • Enhanced handling of micro wake word detections
  • Fixed issues with the logger options in select
  • Improved web server functionality for external components

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.5.05 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

Key updates in this release include:

  • Added support for CUBIC PM2005/PM2105 Laser Particle Sensor Module
  • Implemented yaml-configured maps
  • Added new display driver for MIPI DBI devices
  • Improved BLE connection reliability
  • Various performance optimizations and bug fixes

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.4.26 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

Key updates in this release include:

  • Fixed unexpected widget update behavior
  • Improved BLE handling for ESP32-C6
  • Enhanced media player actions
  • Various bug fixes and performance optimizations

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.4.16 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

Key updates in this release include:

  • Various performance optimizations and bug fixes

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.4.06 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

Key updates in this release include:

  • Added support for MCP4461 quad i2c digipot/rheostat
  • Improved handling of BLE connections
  • Enhanced LVGL component with new features and fixes
  • Various performance optimizations and bug fixes

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.3.37 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

Key updates in this release include:

  • Improved handling of fixed font sizes and glyph positioning
  • Fixed issues with media player functionality and pause states
  • Implemented switch restore for LVGL component
  • Updated ESP mDNS to version 1.8.2

Full release notes can be found at https://github.com/esphome/esphome/releases

Version 2025.3.27 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

Key updates in this release include:

  • Improved handling of fixed font sizes
  • Enhanced support for various touchscreen controllers
  • Fixed issues with 1bpp rendering and media player functionality
  • Improved Bluetooth state reporting for LD2450 component

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2025.3.17 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

Key updates in this release include:

  • Improvements to LVGL component initialization and buffer sizing
  • Enhanced support for ft63x6 displays with correct dimension detection
  • Various bug fixes and performance enhancements

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2025.2.28 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

Key Updates:

  • Added several new components, including support for audio ADC/DAC, BLE, resampler, mixer, and speaker
  • Introduced new platforms for uptime, human presence detection, and binary sensors from keystrokes
  • Updates to the esp32_rmt, lvgl, nextion, image, and ili9xxx components
  • Removed old-style platform configuration, platform support in the custom component, and arm/v7 container image support
  • Included various bug fixes and improvements

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2024.12.49 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

This is a small bugfix release for the ESPHome app.

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2024.12.210 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

Highlights:

  • Fixed ESP32 flash size detection
  • Improved Bluetooth connectivity for ESP32 devices
  • Enhanced system stability and reliability

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2024.11.311 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

Highlights:

  • Improved memory management for ESP8266 devices
  • Fixed timestamp calculation issues
  • Enhanced display and graphics handling
  • Improved stability for various components

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2024.11.211 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

Highlights:

  • Fixed issues with modbus reliability and data handling
  • Improved network connectivity and WiFi stability
  • Enhanced display and graphics handling
  • Better keypad and sensor management

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2024.11.111 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

Highlights:

  • Fixed HTTP request handling with parameters
  • Improved audio playback controls
  • Enhanced graphics display handling
  • Better storage management for devices

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2024.10.312 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

Highlights:

  • Fixed display width and height calculations
  • Improved modbus timing reliability
  • Enhanced LVGL image configuration handling

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2024.10.212 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

Highlights:

  • Improved error message for missing MQTT log topic
  • Fixed issues with some LVGL properties not being templatable
  • Resolved a crash on start for voice assistant component

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2024.10.112 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

Highlights:

  • Fixed crash with empty substitutions block.
  • Fixed broken ibeacon_uuid config in BLE RSSI.
  • Auto-load preferences on startup.
  • Added support for custom MAC addresses on Arduino.

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2024.10.012 months ago

⚠️ As usual, please check that your configurations are still working correctly after updating.

This release includes new components, platforms, and improvements:

  • Added support for OpenTherm communication layer and hub
  • New TCA9555 GPIO driver
  • Support for Sharp GP2Y1010AU0F PM2.5 sensor
  • Added AIC3204 audio DAC component
  • New support for Seeed Grove GMxxx multichannel gas sensor
  • Added support for TE-M3200 and NPI-19 pressure sensors
  • New NAU7802 component for load cell amplifiers

Several bug fixes and enhancements have also been implemented, including improvements to the web server, touchscreen functionality, and various component updates.

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2024.9.2last year

⚠️ As usual, please check that your configurations are still working correctly after updating.

This release includes bug fixes and improvements:

  • Fixed an issue with the bl0906 reset energy action
  • Resolved a configuration validation bug related to extras on schemas
  • Improved stability for rp2040 builds

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2024.9.1last year

⚠️ As usual, please check that your configurations are still working correctly after updating.

This is a small bugfix release.

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2024.9.0last year

⚠️ As usual, please check that your configurations are still working correctly after updating.

This release includes several new components and improvements:

  • New components for energy metering, UDP sensor broadcasting, and audio processing
  • Improvements to datetime templating and IPv6 support
  • Enhanced voice assistant capabilities, including configuration options and announce feature
  • Various bug fixes and optimizations

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2024.8.3last year

⚠️ As usual, please check that your configurations are still working correctly after updating.

This release includes improvements to datetime templating, IPv6 support, and build process optimizations.

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2024.8.1last year

⚠️ As usual, please check that your configurations are still working correctly after updating.

This is a small bugfix release.

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2024.8.0last year

🔔 Reminder that ESPHome on Umbrel can now automatically find devices on your local network, thanks to a switch to host network mode.

⚠️ As usual, please check that your configurations are still working correctly after updating.

This release includes the following improvements:

  • Added support for new components including M5Angle8 input device, APDS9306 ambient light sensor, and LYWSD02MMC Xiaomi device
  • Implemented new features like update.perform action and update.is_available condition
  • Improved support for various existing components and platforms
  • Added runtime online image support
  • Enhanced MQTT functionality with extended device info

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2024.7.3last year

🔔 Reminder that ESPHome on Umbrel can now automatically find devices on your local network, thanks to a switch to host network mode.

⚠️ As usual, please check that your configurations are still working correctly after updating.

This release includes the following improvements:

  • Added delay after sending REG_READ_START for pmwcs3
  • Fixed support for Mitsubishi units that only support cooling
  • Improved VAD detection and modified detection computation for micro_wake_word

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2024.7.2last year

🔔 Reminder that ESPHome on Umbrel can now automatically find devices on your local network, thanks to a switch to host network mode.

⚠️ As usual, please check that your configurations are still working correctly after updating.

This is a bugfix release that includes the following changes:

  • Timeout Adjustment: Default timeout set to 4.5 seconds.
  • Redirect Fix: Improved HTTP redirect handling.

Full release notes can be found at https://github.com/esphome/esphome/releases.

Version 2023.12.9last year

🔔 ESPHome on Umbrel can now automatically find devices on your local network, thanks to a switch to host network mode.

⚠️ As usual, please check that your configurations are still working correctly after updating.

This release updates ESPHome from version 2023.11.6.4 to 2023.12.9. A full list of new features, new component support, breaking changes, and bug fixes for versions between 2023.11.6.4 to 2023.12.9 can be found here: https://github.com/esphome/esphome/releases.

Version 2023.11.6last year

⚠️ As usual, please check that your configurations are still working correctly after updating.

This release updates ESPHome from version 2023.2.4 to 2023.11.6. A full list of new features, new component support, breaking changes, and bug fixes for versions between 2023.2.4 and 2023.11.6 can be found here: https://github.com/esphome/esphome/releases.

Version 2023.11.6 release notes:

  • Fix write_speaker without speaker in config
Version 2023.2.42 years ago

This release updates ESPHome from version 2022.6.2 to 2023.2.4. A full list of new features, new component support, breaking changes, and bug fixes for versions between 2022.6.2 and 2023.2.4 can be found here: https://github.com/esphome/esphome/releases.

Version 2023.2.4 release notes:

  • BL0939 state_class set for energy sensors
  • fix wiegand tag parity
  • Fix multiple remote_receivers with triggers esphome#4477 by @jesserockz
Information