ESPEasy, Automate (using) Common Sense, No AI.
May 3, 2026 ยท View on GitHub
| Latest Nightly | Build Status | Downloads | Docs | Patreon | Ko-Fi | PayPal |
|---|---|---|---|---|---|---|
 |  |  |  |  |  |
For ways to support us, see this announcement on the forum, or have a look at the Patreon, Ko-Fi or PayPal links above.
ESPEasy, Automate (using) Common Sense, No AI.
The main objective for ESPEasy is to make people realize they can easily control appliances and act on sensor data.
Anyone can use it and you don't need AI. Only requirement is common sense and appreciate the satisfaction of seeing things just work.
If you can't build it yourself, you don't 'own' it.
So let's make sure YOU control it.
We are more than willing to assist via our forum.
ESPEasy (development branch)
Introduction https://espeasy.readthedocs.io/en/latest/ (and, mostly outdated, wiki: https://www.letscontrolit.com/wiki/index.php/ESPEasy#Introduction)
MEGA This is the development branch of ESPEasy. All new features go into this branch, and it has become the current stable branch. If you want to do a bugfix, do it on this branch.
Check here to learn how to use this branch and help us improving ESPEasy: Starter guide for (local) development on ESPEasy
Web based flasher (experimental)
To make it easier to get started, one may flash a build directly to the ESP from your browser. Currently only Chrome and Edge are supported.
See this flash page to try the new web flash feature.
The web flasher is using ESP Web Tools made by the people behind ESPHome and Home Assistant.
Binary releases
On demand, controlled by the repo owner, our build-bot will build a new binary release: https://github.com/letscontrolit/ESPEasy/releases
The releases are named something like 'mega-20220626' (last number is the build date)
Depending on your needs, we release different types of files:
The name is built up from a few key parts:
ESPEasy_mega_[releasedate]_[build-type]_[opt-arduino-library]_[hardware-type]_[flash-size][filesystem-size]_[opt-build-features].bin
[build-type] can be any of:
| Build type | Description | included plugins |
|---|---|---|
| climate A | Plugins related to climate measurement A | Stable + Climate A |
| climate B | Plugins related to climate measurement B | Stable + Climate B |
| custom | Custom predefined set/Defined in Custom.h | Specific |
| normal | Standard plugins | Stable |
| collection_A | Normal + plugin collection A | Stable + Collection base + set A |
| collection_B | Normal + plugin collection B | Stable + Collection base + set B |
| collection_C | Normal + plugin collection C | Stable + Collection base + set C |
| collection_D | Normal + plugin collection D | Stable + Collection base + set D |
| collection_E | Normal + plugin collection E | Stable + Collection base + set E |
| collection_F | Normal + plugin collection F | Stable + Collection base + set F |
| collection_G | Normal + plugin collection G | Stable + Collection base + set G |
| collection_H | Normal + plugin collection H | Stable + Collection base + set H |
| max | All available plugins | All available |
| max32 | All available plugins, 32MB Flash | All available, large file system |
| energy | All plugins related to energy measurement | Stable + Energy measurement |
| display A | All plugins related to displays A | Stable + Displays A |
| display B | All plugins related to displays B | Stable + Displays B |
| neopixel | All plugins related to neopixel | Stable + Neopixel |
| hard | hardware specific builds | Minimal |
| minimal | minimal plugins for specific use-cases | Switch and Controller |
| spec_* | specialized technical builds | Not intended for regular use |
| IRext | Infra-red hardware specific | Sending and receiving IR cmd |
| safeboot | (Experimental) safeboot build to enablemost/all plugins on 4MB Flash boards | None |
[opt-arduino-library] (optional) can be any of:
| Arduino library | Description |
|---|---|
| alt_wifi | Alternative WiFi configuration |
| beta | Arduino Beta release |
| sdk3 | Arduino SDK v.3 |
| core_274 | Arduino Core 2.7.4 release |
| core_312 | Arduino Core 3.1.2 release |
| core_274_sdk3 | Arduino Core 2.7.4 SDK v.3 release |
[hardware-type] can be any of:
| Hardware type | Description |
|---|---|
| ESP8266 | Espressif ESP8266/ESP8285 generic boards |
| WROOM02 | Espressif ESP8266 WRoom02 boards |
| ESP32 | Espressif ESP32 generic boards |
| ESP32solo1 | Espressif ESP32-Solo1 generic boards |
| ESP32s2 | Espressif ESP32-S2 generic boards |
| ESP32c3 | Espressif ESP32-C3 generic boards |
| ESP32s3 | Espressif ESP32-S3 generic boards |
| ESP32c2 | Espressif ESP32-C2 generic boards |
| ESP32c6 | Espressif ESP32-C6 generic boards |
| ESP32c61 | Espressif ESP32-C61 generic boards (experimental) |
| ESP32c5 | Espressif ESP32-C5 generic boards (experimental) |
| ESP32p4 | Espressif ESP32-P4 (Rev.1) generic boards |
| ESP32p4r3 | Espressif ESP32-P4 (Rev.3/P4X) generic boards |
| ESP32-wrover-kit | Espressif ESP32 wrover-kit boards |
| SONOFF | Sonoff hardware specific |
| other_POW | Switch with power measurement |
| Shelly_1 | Shelly 1 switch |
| Shelly_PLUG_S | Shelly plug S switch with power measurement |
| Ventus | Ventus W266 weather station |
| LCtech_relay | LC-tech serial switch |
N.B. Starting 2022/07/23, 1M ESP8266 builds can also be used on ESP8285 units and thus there is no longer a specific ESP8285 build anymore.
[flash-size] can be any of:
| Flash size | Description |
|---|---|
| 1M | 1 MB with 128 kB filesystem |
| 2M | 2 MB with 128 kB filesystem |
| 2M256 | 2 MB with 256 kB filesystem |
| 2M320k | 2 MB with 320 kB filesystem |
| 4M1M | 4 MB with 1 MB filesystem |
| 4M2M | 4 MB with 2 MB filesystem |
| 16M | 16 MB with 14 MB filesystem |
| 4M316k | 4 MB with 316 kB filesystem |
| 8M1M | 8 MB with 1 MB filesystem |
| 16M8M | 16 MB with 8 MB filesystem |
| 32M20M | 32 MB with 20 MB filesystem |
N.B. Starting with release 2023/12/25, All ESP32 LittleFS builds use IDF 5.3, to support newer ESP32 chips like ESP32-C2 and ESP32-C6, and SPI Ethernet. Other SPIFFS based ESP32 builds will be migrated to LittleFS as SPIFFS is no longer officially available in IDF 5 and later. As a temporary solution, a specially crafted IDF 5.1 build that still includes SPIFFS, is used for the SPIFFS builds. A migration plan is available, here.
N.B.2 Starting with builds made after 2025/11/04, ESP32 builds will no longer have _LittleFS in the name as all ESP32 builds use LittleFS. Also the suffix _ETH has been removed since all builds will have Ethernet support, except for ESP32C2 builds.
[opt-build-features] can be any of:
| Build features | Description |
|---|---|
| LittleFS | Use LittleFS instead of SPIFFS filesystem (SPIFFS is unstable > 2 MB, and no longer supported in IDF > 5) |
| VCC | Analog input configured to measure VCC voltage (ESP8266 only) |
| OTA | Arduino OTA (Over The Air) update feature enabled |
| Domoticz | Only Domoticz controllers (HTTP) and plugins included |
| Domoticz_MQTT | Only Domoticz controllers (MQTT) and plugins included |
| FHEM_HA | Only FHEM/OpenHAB/Home Assistant (MQTT) controllers and plugins included |
| ETH | Ethernet support enabled (ESP32 and IDF 5.x based builds) |
| OPI_PSRAM | Specific configuration to enable PSRAM detection, ESP32-S3 only |
| CDC | Support USBCDC/HWCDC-serial console on ESP32-C3, ESP32-S2, ESP32-S3, ESP32-C6, ESP32-C61 and ESP32-C5 |
| noOTA/NO_OTA | Does not support OTA (Over The Air-updating of the firmware) Use the flash page or ESPTool via USB Serial |
N.B. Starting ca. 2025/02/27, many ESP32 builds are only available with _ETH suffix, indicating that Ethernet support is enabled, to reduce the (rather high) number of builds.
Some example firmware names:
| Firmware name | Hardware | Included plugins |
|---|---|---|
| ESPEasy_mega-20260121_normal_ESP8266_1M.bin | ESP8266/ESP8285 with 1MB flash | Stable |
| ESPEasy_mega-20260121_normal_ESP8266_4M1M.bin | ESP8266 with 4MB flash | Stable |
| ESPEasy_mega-20260121_collection_A_ESP8266_4M1M.bin | ESP8266 with 4MB flash | Stable + Collection base + set A |
| ESPEasy_mega-20260121_normal_ESP32_4M316k.bin | ESP32 with 4MB flash | Stable |
| ESPEasy_mega-20260121_collection_A_ESP32_4M316k.bin | ESP32 with 4MB flash | Stable + Collection base + set A |
| ESPEasy_mega-20260121_collection_B_ESP32_4M316k.bin | ESP32 with 4MB flash | Stable + Collection base + set B |
| ESPEasy_mega-20260121_max_ESP32s3_8M1M.bin | ESP32-S3 with 8MB flash, CDC-serial, Ethernet | All available plugins |
| ESPEasy_mega-20260121_max_ESP32s3_8M1M_OPI_PSRAM.bin | ESP32-S3 8MB flash, PSRAM, CDC-serial, Ethernet | All available plugins |
| ESPEasy_mega-20260121_max_ESP32_16M8M.bin | ESP32 with 16MB flash, LittleFS, Ethernet | All available plugins |
The binary files for the different ESP32 variants (S2, C3, S3, C2, C6/C61, C5, P4, Solo1, 'Classic') are available in separate archives.
To see what plugins are included in which collection set, you can find that on the ESPEasy Plugin overview page
For ESP32 builds (all models) there are 2 .bin files available:
- a
.factory.binto be used when flashing the firmware via external tools, like the Espressif Flash Download tool, to be loaded at address0x0, that includes the bootloader and flash-partitioning data. This is the second of 2 recommended methods to install ESPEasy on a new device.
The main recommended method for flashing ESPEasy onto a (new) device is via this flash page (using Chrome or Edge webbrowser), where you connect the device via USB-serial, and select what firmware-build to install. - a 'regular'
.binfile, that can be used to update a running board via OTA (Over The Air), using the Update Firmware button on the Tools page. The .bin file then has to be available for the device the webbrowser is running from (local or via a network), as the file is uploaded via the webbrowser.
The firmware to upload via OTA must match both the ESP32 model, and current partitioning & formatting, LittleFS as indicated in the name, or SPIFFS.
Documentation & more info
Our new, in-depth documentation can be found at ESPEasy.readthedocs.io. Automatically built, so always up-to-date according to the contributed contents. The old Wiki documentation can be found at letscontrolit.com/wiki.
Additional details and discussion are on the "Experimental" section of the forum: https://www.letscontrolit.com/forum/viewforum.php?f=18
SAST Tools
PVS-Studio - static analyzer for C, C++, C#, and Java code.
Icons used
Icons on courtesy of ICONS8.