Skip to content

Simplify your ESPHome setup with the new desktop app

Simplify your ESPHome setup with the new desktop app

Last month, we introduced the ESPHome Device Builder: a more visual and intuitive tool for configuring your smart home devices without having to write any code, unless you want to! Now we’ve taken a further step in our efforts to make ESPHome more approachable, by bringing the Device Builder to your desktop in a quick and easy way.

Say hello to the ESPHome Device Builder desktop app, available now for macOS, Windows, and Linux.

If you’ve already tried the Device Builder, you’ll know how much friction it removes from configuring a device. But for a lot of newcomers, there was still a hurdle to clear before getting started: the technical tasks of installing Python and typing commands in a terminal. Not that hard if you’ve done it before… but if you haven’t, it’s a process that could turn a Saturday afternoon project into a weekend of troubleshooting.

The desktop app removes that hurdle, and is designed to be simple to set up.

Download the app for your platform, run the installer… and that’s it. On first launch:

  • The app quietly sets everything up in the background: no technical steps required.
  • It opens the Device Builder automatically in your browser.
  • A small icon appears in your system tray, giving you access to reopen the Device Builder, check for updates, or quit: no digging through tabs or task managers.

That tray icon stays there for as long as you use ESPHome: it’s your quick way back in, every time, not just on day one. And because the app is designed to run locally, on your own computer, there’s no login or password to set up, so it’s ready to use the moment it opens.

Think back to the workshop metaphor from our last post: the Device Builder itself is the well-organized bench where the creative work happens. The desktop app is what makes it easy – and low stakes – to walk in and start that work. So if you’re faced with your first microcontroller (the imminent ESPHome Starter Kit perhaps 👀), there’s no technical setup standing between unboxing and beginning your build: just download the app, and away you go.

It’s not just the start-up that’s easy. Every time you want to tweak a device or add a new one, it’s the same simple open-and-go experience, with no need to remember any previous commands.

When you start slightly more advanced projects, the desktop app can help with other elements of your setup. For example if you run ESPHome on a lower-powered device, like a Raspberry Pi, you can have it send the heavy lifting of compiling firmware over to the app instead, then send the finished result back. It’s a handy way to speed up builds without changing how or where you actually flash your devices.

The app is also useful for anyone helping a less technical friend or family member get started. “Download this app and open it” is an instruction anyone can follow. “Install Python, then pip install this, then run this command” is not.

Don’t mistake the beginner focus for a lack of depth. If you’re setting up ESPHome on a new machine, spinning up a build environment for a demo, or just tired of manually checking the latest Device Builder version, the desktop app handles all that for you. Update checks live right in your system tray: no more remembering to consult the changelog yourself.

What’s more, nothing about your existing workflow changes. If you’re already running ESPHome through pip, Docker, or the Home Assistant add-on, you’re unaffected: the desktop app is simply another door into the same Device Builder, for people who’d rather not open a terminal at all.

Ready to give it a go? Here’s how to get started in three simple steps:

  1. Download the app: For macOS, Windows, or Linux from esphome.io/install.
  2. Open it and let it work: ESPHome sets itself up in the background, no configuration needed.
  3. Start your first project: Dive straight into the Device Builder that opens automatically, and explore the Component Catalog we introduced last month.

If you’re already comfortable with pip, Docker, or the Home Assistant App, there’s nothing you need to change. The desktop app is an additional on-ramp, not a replacement for how you already work… it’s there for the next person who’s about to start exploring the wonderful world of ESPHome!

Comments