Getting started with Glassworks
On this page
Glassworks turns a wall panel or Android tablet into a dedicated, local Home Assistant device. Once installed, your panel boots straight into your Home Assistant dashboard full screen and appears in Home Assistant as a single ESPHome device—giving you screen controls, sensors, voice control, timers, synced Music Assistant playback, notifications, and (on supported hardware) a Zigbee or Thread radio.
Everything runs on your local network. There is no custom Home Assistant integration to install, no cloud service, and no Glassworks account to create.
Supported devices
Glassworks supports dedicated wall panels as well as standard Android tablets:
| Device | Support | How it installs |
|---|---|---|
| Aqara Panel Hub S1 Plus | Beta | Rooted install from your browser with Kiln over USB-C. Supports every feature, including the built-in Zigbee/Thread radio, presence sensor, and wall base relays. |
| Generic Android | Under development | Installs as a regular Android app (Android 8+, with a legacy build for Android 6–7). No root needed. Runs every feature your device's hardware supports, including tested devices like the Google Pixel Tablet. |
| lululemon Studio Mirror | Under development | Installs the legacy Android build via Kiln onto the 40-inch mirror display. |
You can also browse all supported and planned hardware with interactive 3D previews at glassworks.dev/frames.
What you need
- A supported panel or Android device
- A USB data cable plugged directly into your computer (avoid USB hubs and charge-only cables)
- Google Chrome or Microsoft Edge on Windows, macOS, or Linux (Kiln uses WebUSB, which Firefox and Safari do not support)
- Home Assistant on the same local network (2026.11 or newer is recommended so Home Assistant sets up ESPHome encryption automatically)
- About 10 minutes
If you are installing on an Aqara S1 Plus, you will also need a small screwdriver to open the back cover once and reach the recovery button on the circuit board.
1. Install Glassworks with Kiln
Kiln is the Glassworks web installer. It runs entirely inside your browser—nothing is uploaded to a server—and walks you through the installation step by step.
- Open kiln.glassworks.dev in Chrome or Edge and choose your device.
- Follow the on-screen instructions to connect your panel over USB.
- On the Aqara S1 Plus, Kiln first boots a temporary installer in RAM, backs up your panel's original partitions, patches the boot image, and verifies every write by reading it back. See the Aqara S1 Plus install guide for OS-specific USB setup and troubleshooting.
- On Generic Android, Kiln installs the app over USB debugging, grants the permissions it needs, and sets it as your home screen. See the Generic Android guide for details.
- Complete the setup prompts in Kiln to configure your language, time zone, Wi-Fi, Home Assistant sign-in, and (on the S1 Plus) your radio role.
- Download and save your backup on the final screen if Kiln created one. On the Aqara S1 Plus, the
.ziparchive from your first install is the only copy of your original Aqara software and lets you undo the install at any time.
2. Finish first-boot setup
If you skipped Wi-Fi or Home Assistant sign-in in Kiln—or installed the app directly on an Android tablet—Glassworks opens a guided setup screen on the panel itself.
Connect to Wi-Fi
You can connect the panel to Wi-Fi in any of three ways:
- During Kiln setup over USB (the fastest option).
- Over Bluetooth (Improv) from Home Assistant or a phone, after approving the prompt on the panel's screen.
- From your phone using the panel's setup Wi-Fi. Tap Set up from a phone (or wait 3 minutes with no network connection), scan the QR code on the panel to join its temporary Wi-Fi network, and open the setup address (
http://<panel>:8099/setup) to enter your home Wi-Fi credentials.
Sign in to Home Assistant
Rather than typing a password on a wall screen, Glassworks signs in with a QR code:
- Confirm the Home Assistant address found on your network (or enter it manually).
- Scan the QR code on the panel with your phone and sign in to Home Assistant as usual.
- The panel receives its dashboard sign-in automatically and moves to the next step.
You can also complete setup from a laptop on the same network at http://<panel>:8099/setup by pairing with a 6-digit code shown on the panel. See Set up over the network for details.
Adopt the panel in Home Assistant
Once the panel is on your network, Home Assistant discovers it automatically over mDNS.
- Open Home Assistant and go to Settings → Devices & services.
- Look for the discovered ESPHome device (for example, Aqara S1 Plus or Pixel Tablet) and click Add.
- On Home Assistant 2026.11 and newer, encryption is provisioned automatically—you never need to copy or manage an encryption key.
If your panel is on a separate VLAN where mDNS does not reach Home Assistant, click Add integration → ESPHome, enter the panel's IP address, and use port 6053.
3. Pick your dashboard
By default, Glassworks loads your default Home Assistant dashboard and hides the Home Assistant header and sidebar so the view fills the screen cleanly.
To display a specific dashboard:
- In Home Assistant: open the panel's ESPHome device page, expand the disabled entities, enable the Dashboard select entity (or Dashboard URL), and pick the dashboard you want.
- On the panel or Manage page: open the hidden settings menu on the panel by tapping the top-left corner five times, or open the Manage page at
http://<panel>:8099/from your browser and go to Home Assistant & dashboard.
Where to go next
Once your dashboard is up and running, explore what else your panel can do:
- The Manage page — Check panel health, adjust settings, view logs, and manage multiple panels from your browser.
- Voice and timers — Set up on-device wake words for Home Assistant Assist, on-screen voice timers, and spoken announcements.
- Music Assistant (Sendspin) — Stream synchronized multi-room audio straight to your panel from Music Assistant.
- Notifications — Display rich alerts with camera snapshots, action buttons, chimes, or full-screen doorbell views.
- ESPHome entities — Browse every sensor, switch, and control your panel exposes to Home Assistant.
- Blueprints — Import ready-made Home Assistant automations for night mode, doorbells, interactive prompts, and motion lighting.
- Using the Zigbee/Thread radio — Turn the Aqara S1 Plus radio into a ZHA coordinator, Zigbee2MQTT coordinator, Thread border router, or network repeater.
- Updates and restoring stock software — Keep Glassworks updated through Home Assistant and learn how to revert to stock firmware.