For Windows
Works on Windows 10 and Windows 11.
Install
- Open the downloaded
.exefile. - If Windows asks "Do you want to allow this app to make changes?", choose Yes.
- Follow the installer prompts.
- Launch ESPHome Device Builder from the Start menu.
If you see "Windows protected your PC", click More info → Run anyway.
For macOS
macOS 10.15 Catalina or newer.
Install
- Open the downloaded
.dmgfile. - Drag ESPHome Device Builder into the Applications folder.
- Open the Applications folder and double-click ESPHome Device Builder.
- The first time you run it, macOS may ask you to confirm — click Open.
Not sure which Mac you have? Click the Apple menu → About This Mac. If you see Apple M1/M2/M3/M4, pick Apple Silicon. If you see Intel, pick Intel.
For Linux
Choose the format that matches your distribution.
Install
Double-click the file in your file manager, or run:
sudo apt install ./ESPHome.Device.Builder_*.debDouble-click the file in your file manager, or run:
sudo dnf install ./ESPHome.Device.Builder-*.rpmInstall the esphome-desktop-bin package with your favourite AUR helper:
yay -S esphome-desktop-binor:
paru -S esphome-desktop-binMake it executable and run it:
chmod +x ESPHome.Device.Builder_*.AppImage
./ESPHome.Device.Builder_*.AppImageIf serial devices don't show up, add your user to the
dialout group and log out and back in: sudo usermod -a -G dialout $USER.What happens on first launch?
The app sets up ESPHome in the background and opens the Device Builder in your browser. A small icon appears in your system tray for quick access — open the Device Builder, check for updates, or quit from there.