Skip to content

Releases: esphome/ewt-gen

1.4.3

18 May 17:57
c1a3723

Choose a tag to compare

What's Changed

  • Resolve ESPHome config before chip detection by @balloob in #11

Full Changelog: 1.4.2...1.4.3

1.4.2

10 May 21:02

Choose a tag to compare

Bug fixes

  • Fix factory image lookup: ESPHome writes firmware.factory.bin (dot), not firmware-factory.bin (dash). 1.4.1 missed the file and silently fell back to the OTA-only firmware.bin, producing unbootable downloads.
  • Remove the firmware.bin fallback entirely. If the factory image is missing, ewt-gen now fails with a clear error instead of shipping an app-only binary that has no bootloader or partition table.

1.4.1

10 May 15:19

Choose a tag to compare

Bug fixes

  • Use factory firmware image (firmware-factory.bin) when generating the ESP Web Tools manifest. The previous behavior returned firmware.bin (the OTA app-only image), which left flashed devices without a bootloader or partition table and unable to boot.

1.4.0

10 May 03:32
e2fc415

Choose a tag to compare

Add --dev flag to install ESPHome from the dev branch via uvx, for configs that depend on unreleased ESPHome features.

1.3.1

15 Jan 05:09

Choose a tag to compare

  • Fix publish command set right version

1.3.0

15 Jan 05:01

Choose a tag to compare

Multi-config support

Generate a single website that supports multiple chip variants (ESP32, ESP32-C3, ESP32-S2, etc.).

Usage

uvx ewt-gen esp32.yaml esp32c3.yaml esp32s3.yaml -o output/

Features

  • Multiple YAML sources: Pass multiple configs to create a combined site
  • Validation: Ensures all configs have the same esphome.project.name and no duplicate chip families
  • Tabbed UI: Users select their chip variant to see the correct firmware download and configuration
  • Version badge: Shows firmware version next to the title
  • Smart output directory: Defaults to project name for multi-config (e.g., esphome.webesphome-web/)

Generated output

esphome-web/
├── esp32.yaml
├── esp32c3.yaml
├── firmware-esp32.bin
├── firmware-esp32c3.bin
├── index.html
└── manifest.json

The manifest.json contains all chip variants, and ESP Web Tools auto-detects the connected device.

1.2.0

15 Jan 04:17

Choose a tag to compare

What's New

  • --publish-url - Generate factory firmware with OTA update support and ESPHome Dashboard import
  • --fw-version - Specify firmware version (or auto-read from esphome.project.version)
  • Expandable YAML configuration viewer in generated site
  • Improved HTML template layout

See README for usage details.

1.1.0

15 Jan 02:41

Choose a tag to compare

  • Fix version command
  • Delete build dir after building from URL
  • Add CLAUDE file

Full Changelog: 1.0.0...1.1.0

1.0.0

14 Jan 21:43

Choose a tag to compare

Initial release