Releases: esphome/ewt-gen
Releases · esphome/ewt-gen
1.4.3
1.4.2
Bug fixes
- Fix factory image lookup: ESPHome writes
firmware.factory.bin(dot), notfirmware-factory.bin(dash). 1.4.1 missed the file and silently fell back to the OTA-onlyfirmware.bin, producing unbootable downloads. - Remove the
firmware.binfallback entirely. If the factory image is missing,ewt-gennow fails with a clear error instead of shipping an app-only binary that has no bootloader or partition table.
1.4.1
Bug fixes
- Use factory firmware image (
firmware-factory.bin) when generating the ESP Web Tools manifest. The previous behavior returnedfirmware.bin(the OTA app-only image), which left flashed devices without a bootloader or partition table and unable to boot.
1.4.0
1.3.1
1.3.0
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.nameand 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.web→esphome-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
What's New
--publish-url- Generate factory firmware with OTA update support and ESPHome Dashboard import--fw-version- Specify firmware version (or auto-read fromesphome.project.version)- Expandable YAML configuration viewer in generated site
- Improved HTML template layout
See README for usage details.
1.1.0
- Fix version command
- Delete build dir after building from URL
- Add CLAUDE file
Full Changelog: 1.0.0...1.1.0