A Homey app that turns a Shelly Wall Display (or any compatible touchscreen device) into a smart home control panel — powered by your Homey devices.

The app runs a local HTTP/WebSocket server on your Homey that emulates the Home Assistant API. The Shelly Wall Display connects to it as if it were a Home Assistant instance, while the actual device data and control come entirely from Homey.

• Live dashboard — all Homey devices as touch tiles, real-time state updates via Server-Sent Events (SSE) with adaptive fallback polling
• Device control — toggle lights, sockets, locks, fans, blinds, heaters, TVs, and more directly from the wall
• Dimmer support — tap anywhere on a dimmer tile to toggle on/off; drag the slider to adjust brightness; both gestures work independently
• Alarm control — arm, disarm, or partially arm your home alarm; view motion and contact alerts
• PIN protection — optional 4-digit PIN for the home alarm, configurable in the settings page
• Camera & doorbell snapshots — tap a camera or doorbell tile to view the latest image with auto-refresh
• External sensors — reed contacts and similar sensors (e.g. garage door) shown as Open / Closed; tile turns red when open
• Sensor readings — temperature, humidity, CO₂, and power consumption shown inline on each tile

• One-tap flow triggers — select any manually-triggerable Homey flow in the settings to show it as a button on the dashboard
• Visual feedback — spinner while triggering, green ✓ on success, red ✕ on error
• Basic and Advanced Flows — supports both classic flows and Advanced Flows (Homey ≥ 10)
• Adjustable tile width — flow tiles can use their natural width (dynamic) or match the width of device tiles exactly
• Show camera on dashboard — Flow action card that automatically opens a camera or doorbell snapshot on the dashboard when a Flow runs; select a specific display or broadcast to all; ideal for doorbell automations

• Room grouping — devices organised by Homey zones, with a toggle to view all devices in a flat list; tap a room title to collapse or expand its tiles
• Room filter — ☰ burger menu icon in the header opens a chip bar listing all active rooms; tap a chip to filter to that room, tap again to clear; chips wrap to multiple lines on small screens (no horizontal scrolling); room order follows the configured zone order
• Device class filters — optional shortcut buttons in the header to filter by Cameras, Media Players, Thermostats, Lights, or Blinds; each can be enabled independently in Settings → Design
• Search — 🔍 icon in the header opens a search field; press Enter to confirm the filter (keyboard closes, filter stays active); tap the icon again to edit, ✕ to clear; disabled by default, enable in Settings → Design
• Room order — drag and drop rooms into any order via the Design settings
• Drag & drop reordering — long-press a tile to drag it to a new position; order is saved across reloads
• Adjustable tile width — choose from XS / S / M (default) / L / XL via the settings page
• Adjustable tile height — Auto (content-driven) or Same as width (square tiles)
• Tile layout — values, status and device name always aligned to the bottom of each tile for a clean, consistent look
• Theme mode — Light, Dark, Toggle (manual header button), or Auto (light 07:00–21:00, dark otherwise); configurable in Settings → Design; the header button is hidden in Light / Dark / Auto modes
• Clock — live clock in the header, drift-corrected
• Tile Colors — optional state-based tile coloring: choose Subtle or Strong intensity, set a custom active color (default green), an optional inactive color for switchable devices, and a flow button color; sensors and cameras are never tinted
• Header-hidden shortcuts — when the header is hidden for a clean full-screen look, ⚡ Energy and 🚗 EV shortcut tiles appear automatically in the flow area so both dashboards remain accessible

• Weather tile — optional tile at the top of the dashboard showing current conditions: weather emoji, temperature, description, wind speed, and city name; tap to open the forecast modal
• Header button — optional 🌤️ button in the header bar (independent of the tile) that also opens the forecast modal
• Forecast modal — two tabs:
  • Today — current conditions (feels like, humidity, wind, pressure) plus an hourly strip (every 3 hours, full-width, scrollable)
  • 7 Days — daily forecast with high/low temperatures, weather emoji, rain probability, and precipitation
• Free API — powered by Open-Meteo — no API key required
• Auto-location — latitude and longitude are automatically populated from Homey's geolocation on first launch; can be overridden with a city search or the 📍 Homey location button in the settings
• Temperature unit — °C or °F, configurable in the Design settings
• Disabled by default — enable the tile and/or header button in the Design settings

• Flow diagram — Tesla-style animated SVG with dark circular nodes and colored rings showing real-time energy flows between Solar, Grid, Home, and Battery
• T-junction layout — Solar top-center, Grid bottom-left, Home bottom-right, Battery bottom-center; orthogonal connectors with a single animated dot per active line
• Inactive nodes — nodes with no active flow are shown in grey (no value, dimmed icon) so you can instantly see what is producing or consuming
• Three tabs — Live (flow diagram), Devices (per-device power cards), 7 Days (bar chart with solar production and grid import)
• 7-day history chart — bar chart with solar production and grid import per day
• Animated flow lines — travelling dots indicate direction; inactive connections shown as dashed lines
• Invert battery sign — option for systems that report positive power when discharging (e.g. GoodWe SMILE, some Fronius inverters)
• Exclude support — devices marked as "Exclude from Energy" in Homey are automatically hidden
• Enable / disable — the ⚡ Energy button can be hidden via the settings page

• Dedicated EV panel — tap the 🚗 header button to open a modal with your electric vehicle's live status; disabled by default, enabled in the Design settings
• Any Homey device — pick any device from your Homey as the EV; not limited to a specific driver
• Car image — upload a PNG or JPEG photo of your car; PNG transparency is preserved (no black background)
• Battery bar — live state-of-charge bar with percentage label; pulses when actively charging
• Charging state badge — ev_charging_state shown as a colored pill above the battery bar:
  • ⚡ Charging (green, pulsing bar)
  • 🔌 Plugged in / Waiting (amber)
  • 🔌 Unplugged (plugged_out) (grey)
  • 🚗 Driving / Discharging (grey)
  • — Not connected (grey)
• Capability cards — select any device capabilities in the settings; each shows an icon, formatted value, and label
• Capability picker — standard EV caps (measure_battery, ev_charging_state) are pre-selected and highlighted with an orange "EV" badge in the settings
• Auto-refresh — EV data polls every 30 seconds while the modal is open

• Instant capability updates — per-device makeCapabilityInstance subscriptions (homey-api V3) fire the moment Homey commits any capability value change; physical switch presses appear on the dashboard in under 1 second
• SSE fast path — capability changes are broadcast over Server-Sent Events immediately; the card updates within a single animation frame
• Fallback polling — full device state poll every 120 s (SSE active) / 10 s (SSE inactive) as a safety net; makeCapabilityInstance delivers real-time updates so frequent polling is unnecessary
• SSE reconnect backoff — exponential backoff (1 s → 2 s → 4 s → … → 30 s) after connection loss
• Auto-refresh — full data reload every 5 minutes and on header logo tap
• XHR timeout — all requests time out after 10 seconds to prevent a frozen UI

Shelly Wall Display  /  any browser
          │
          │  HTTP + WebSocket (Home Assistant protocol)
          ▼
Homey App (com.walldisplay.dashboard)
          │
          │  Homey Web API
          ▼
     Your Homey Devices

1. The Homey app starts an HTTP/WebSocket server (default port 7575) on your local network.
2. The Shelly Wall Display is configured to connect to http://<homey-ip>:7575.
3. The display completes a simulated Home Assistant authentication handshake.
4. The dashboard UI loads and fetches your devices and zones from Homey.
5. An SSE stream delivers live device state changes to the display as they happen.
6. Tapping a device card sends a control command back to Homey via the REST API.

Tip: The dashboard URL also works in any regular browser (Chrome, Safari, Firefox) — just open it on any device on your local network.

1. Install the app on your Homey via the Homey App Store or by sideloading with the Homey CLI.
2. Open the app settings in the Homey app.
3. Note the displayed dashboard URL (e.g. http://192.168.1.x:7575).
4. On your Shelly Wall Display: Settings → Network → Home Assistant → Add URL and enter the URL.
5. The display connects automatically and loads the dashboard.

The settings page is organised into four tabs:

Configure what each display shows. Every profile has two collapsible sections — Devices and Flows — that let you choose exactly what appears on that display.

Default profile — always present, applies to all displays that have no matching IP profile.

IP profiles — add one per Shelly Wall Display. The display is matched by its IP address. Each IP profile overrides the default for that specific display. Profiles can be deleted with a two-click confirmation (click ✕, then confirm).

Note on flow triggering: Due to a Homey platform restriction, apps cannot trigger flows using their internal token. A Personal Access Token (set in the General tab) is required — this feature requires a Homey Pro 2023 or later. Create one at my.homey.app under Account → Developer → API Keys with full permissions.

Tools for diagnosing camera, speaker, and logging issues. All output is shown in copyable black code fields.

• Homey with Homey Web API (homey:manager:api permission) and geolocation (homey:manager:geolocation for auto-location)
• Homey SDK v3, compatibility >=5.0.0
• A Shelly Wall Display or any device / browser that can connect to a local HTTP server
• A Personal Access Token (for flow triggering only — requires Homey Pro 2023 or later)

com.walldisplay.dashboard/
├── app.js                  # Homey app entry point — HTTP/WebSocket server, Homey API integration
├── app.json                # App manifest (id, permissions, api declarations, metadata)
├── api.js                  # Homey SDK v3 API module — debug endpoints callable from settings page
├── package.json            # Node.js dependencies
├── assets/
│   ├── icon.svg            # App icon
│   └── images/             # App store images (small / large / xlarge)
├── dashboard/
│   ├── index.html          # Dashboard HTML shell
│   ├── client.js           # Frontend logic (rendering, SSE, controls, energy, flows, drag & drop, PIN)
│   ├── style.css           # Touch-optimised styles (dark/light mode, tile sizes, flow tiles)
│   └── device-icons/       # SVG device icons served locally
└── settings/
    └── index.html          # Settings UI — tabs: General, Design, Profiles, Debug

If you enjoy this app, consider buying me a beer 🍺

MIT