HomeTiles
HomeTiles is free, open-source firmware that turns a supported touch display into a Home Assistant control panel. Use tiles to switch lights, adjust heating, control music, and see sensor or energy data at a glance.
Get started
- Flash the firmware using the online flasher. Choose your exact device and installation mode.
- Connect Home Assistant through the MQTT broker and HomeTiles Bridge.
- Configure your dashboard in the display's Web Admin panel.
- Use the display to control devices and view their data.
Features
- Controls: lights, switches, covers, heating, media, numbers, selections and date/time values.
- Sensors & energy: live values, state history, energy statistics and weather.
- Dashboard: arrange tiles and folders with a live browser preview; open views from Home Assistant.
- Screensaver: display a clock, photos and sensor tiles.
- Local hardware: use supported GPIO outputs, relays and temperature sensors.
- Updates: install firmware from the display or your browser.
- Camera: experimental live video on ESP32-P4 displays.
All tile types and screensaver configuration.
Demo
Device Support
Match the exact hardware revision before flashing. Open online flasher.
ESP32-P4
| Model | Display | Status | Link |
|---|---|---|---|
| M5Stack Tab5 | 5" / 1280×720 | Tested | Link |
| Waveshare LCD-4B (P4) | 4" / 720×720 | Tested | Link |
| Waveshare 86 Panel ETH-2RO | 4" / 720×720 | Tested | Link |
| Waveshare LCD-8 (P4) | 8" / 1280×800 | Tested | Link |
| Guition JC8012P4A1 V1 | 10.1" / 1280×800 | Tested | Link |
| Waveshare LCD-4.3 (P4) | 4.3" / 800×480 | Partial | Link |
| Waveshare LCD-7 (P4) | 7" / 1280×720 | Pending | Link |
| Waveshare 7B/7B-C (P4 pre-v3) | 7" / 1024×600 | Pending | Link |
| Waveshare 7B/7B-C (P4 v3.1) | 7" / 1024×600 | Experimental | Link |
| Waveshare LCD-10.1 (P4) | 10.1" / 1280×800 | Partial | Link |
| Guition JC8012P4A1 V2 | 10.1" / 1280×800 | Tested | Link |
| Guition JC1060P470C V1 | 7" / 1024×600 | Tested | Link |
| Guition JC1060P470C V2 | 7" / 1024×600 | Partial | Link |
ESP32-S3
| Model | Display | Status | Link |
|---|---|---|---|
| Guition ESP32-4848S040C_I | 4" / 480×480 | Tested | Link |
| Waveshare LCD-4 Rev 4.0 (S3) | 4" / 480×480 | Tested | Link |
| Waveshare LCD-4B (S3) | 4" / 480×480 | Pending | Link |
Hardware-tested by the maintainer.
Hardware-tested by the maintainer. A brief blue flash while saving or updating is a known display limitation.
Hardware operation and native Ethernet are confirmed. Uses the ESP32-P4 LCD-4B firmware.
Hardware-tested by the maintainer. A brief blue flash while saving or updating is a known display limitation.
v0.6.10 includes the V1-specific SDIO receive fix. Camera streams and Web Admin OTA were confirmed stable in the integrated v0.6.9b1 test build. Camera remains experimental.
Display, touch, Wi-Fi, MQTT, Home Assistant and Weather are verified. microSD and OTA checks are still pending.
Firmware is available, but hardware validation is still requested. This 1280 × 720 model uses different firmware from LCD-7B.
A 7B-C was reported working with v0.6.8, without an exact chip revision in the report. Confirmation for this pre-v3 profile is still needed.
Dedicated firmware for exact ESP32-P4 v3.1. Hardware validation for this revision is still pending; v3.2 and newer are unsupported.
Display, touch, Wi-Fi, MQTT and OTA were reported working. Corrected defaults, SD and Camera still need release validation.
Maintainer-tested on JC8012P4A1C_I_W_Y1, SKU:10153002-V2. Display, touch, brightness, MQTT and microSD are confirmed. The interface runs smoothly with the v0.6.12 PPA correction. The SD reboot reported on another unit in issue #38 remains under investigation.
Touch, brightness, SD, Wi-Fi/MQTT and OTA were confirmed working since v0.6.5. Requires the exact _I_W_Y model.
Basic operation is confirmed. v0.6.8 includes the orientation correction; full release and OTA confirmation remain pending.
Hardware-tested by the maintainer. Camera tiles are unavailable; a brief black screen while saving is expected.
First released in v0.6.10. Display, backlight, touch, Wi-Fi, Web Admin, MQTT and Web OTA are contributor-tested. Rev 4.0 only; Camera tiles and SD access are unavailable.
Initial hardware testing was reported with PR #29. The adapted release profile still needs confirmation. No microSD or Camera tiles.
New In v0.6.12
- Faster Guition UI: PPA hardware rotation now handles larger ordinary interface updates on JC8012P4A1 V1 and V2. The improvement is confirmed on V2; V1 hardware feedback is pending.
- Aligned Weather forecasts: both Guition revisions now use the same forecast position as Waveshare 8-inch and 10.1-inch.
- Correct daily temperatures: partial hourly forecasts preserve the provider's full-day minimum and maximum.
- Bridge: use v0.6.44 or newer through HACS. Camera remains experimental and ESP32-P4-only.
Read the v0.6.12 release notes
How It Works
The display exchanges states and commands with an MQTT broker. HomeTiles Bridge connects the broker to Home Assistant, publishes entity data and executes commands from the display.
Firmware and Bridge are MIT-licensed. Support HomeTiles.