Setup guide

From zero to dashboard in 10 minutes.

Install Aureo, point it at Home Assistant, drop in your first tile. Then add cameras, voice, and event-driven automations as you grow.

1. Install

Aureo runs on iPad (iOS 13+), Android tablets (Android 10+, 3 GB RAM), and macOS. Install from the App Store, Google Play, or the Mac App Store. Amazon Fire tablets work via sideloaded APK.

The app is a single download — no companion service, no custom integration, no HACS install. Aureo talks to Home Assistant directly over WebSocket.

2. Connect to Home Assistant

You'll need a Long-Lived Access Token. Generate one in Home Assistant under Profile → Security → Long-lived access tokens → Create Token. Copy it.

  1. Launch Aureo. Tap Connect to Home Assistant.
  2. Enter your HA URL (e.g. http://homeassistant.local:8123 or your Nabu Casa remote URL).
  3. Paste the token. Tap Connect.
Local network recommended Aureo's whole pitch is sub-millisecond entity updates. Local-LAN HA reaches that. Remote URLs work but add WAN latency.

3. Your first tile

Tap Edit in the top-right. Tiles begin to shake. Tap any empty cell to add a tile, pick a type, and choose the entity. Drag tiles to rearrange, drag the corner handle to resize.

The grid is 8 columns on phones, 12 to 24 on tablets, scaled to width. Rows fill the screen height exactly — Aureo dashboards never scroll.

4. Cameras & go2rtc

Aureo connects to cameras directly through go2rtc — not routed through Home Assistant. This is what gets you single-digit-millisecond camera latency.

  1. Install the go2rtc add-on in Home Assistant (Settings → Add-ons → Add-on Store → go2rtc).
  2. Add your camera streams to the go2rtc streams: config.
  3. In Aureo, add a Camera tile and pick the stream from the discovered list.

Each camera tile polls a live JPEG frame every second. The last good frame stays in memory so the tile never flashes black on weak Wi-Fi. Tap to switch the same tile to full WebRTC.

Supported protocols RTSP, Reolink, Eufy, Hikvision, Dahua, ONVIF — anything go2rtc speaks. If go2rtc can stream it, Aureo can render it.

5. PTZ & ONVIF presets

Aureo auto-discovers ONVIF presets on PTZ-capable cameras. Open a camera in fullscreen and the preset capsules appear above the D-pad. Tap to snap.

The D-pad is continuous-move: press and hold to pan, release to stop. The stop command fires immediately on release so cameras don't drift past their target.

Camera-side setup:

  1. Enable ONVIF on the camera. Most Reolink, Hikvision, and Dahua models have it under Network → Advanced → ONVIF.
  2. Create a dedicated ONVIF user with PTZ permission — don't reuse admin.
  3. Save your presets directly on the camera (most camera web UIs have a Preset section under PTZ).
  4. In Aureo's camera-tile config, enter the ONVIF host, port, and credentials.
Tip Some cameras silently rate-limit ONVIF commands. If presets feel sluggish, check whether the camera's RTSP and ONVIF ports share a connection limit — bump it if so.

6. Voice & HA Assist

The Voice tile streams audio from the tablet's microphone into Home Assistant's Assist pipeline. Bring your own STT, conversation agent, and TTS.

  1. In HA, configure an Assist pipeline (Settings → Voice assistants).
  2. In Aureo, add a Voice tile and pick the pipeline.
  3. Hold the talk button, speak, release.

Aureo applies 2.5× software gain so wall-mounted tablets pick up speech from across the room without clipping. On Android, the mic is pre-warmed at mount so the first 2–4 seconds of speech aren't lost.

7. HA Events & blueprints

Every tablet publishes itself as a Home Assistant sensor — sensor.aureo_kitchen_tablet, sensor.aureo_living_room. You can address commands at one tablet, several, or all of them.

The fastest way to wire automations is via Aureo's blueprint catalog:

  1. In Aureo: Settings → HA Events → Blueprints.
  2. Tap Import to HA on the blueprint you want.
  3. Your phone browser opens the HA import dialog. Fill in the inputs (which tablet, which sensor, etc.) and save.

For custom triggers, fire an aureo_command event from any automation:

Doorbell rings → Kitchen tablet opens the camera
trigger:
  platform: state
  entity_id: binary_sensor.front_doorbell
  to: "on"

action:
  event: aureo_command
  event_data:
    command: show_camera
    target: sensor.aureo_kitchen_tablet
    camera: camera.front_doorbell
    wake: true

Eleven commands are available — see the events section on the main page for the full list.

8. Tablet intercom

Any two tablets running Aureo on the same HA instance can call each other. WebRTC peer-to-peer over your local network; signalling rides Home Assistant's event bus. No external server.

  1. Give each tablet a friendly name in Settings → Identity.
  2. Add an Intercom tile on each dashboard.
  3. Pick the target tablet from the dropdown. Hold to Talk, or tap Video Call.

9. Troubleshooting

The dashboard won't connect

Check that the HA URL is reachable from the tablet's network (open it in the tablet's browser). Long-lived tokens don't expire — but if you regenerated yours, you'll need to update Aureo's saved credentials.

Camera tile is black

The tile holds the last good JPEG frame, so a black tile means go2rtc never returned one. Check the go2rtc web UI (port 1984 by default) — the stream should preview there.

PTZ buttons don't do anything

Verify ONVIF is enabled on the camera and the credentials are correct. Aureo doesn't proxy through HA for PTZ — it talks ONVIF directly.

Voice tile transcribes silence

Check the Assist pipeline's STT input level in HA's debug view. If the level meter on the tile shows activity but HA shows none, your network may be dropping audio packets — switch the tablet to 5 GHz Wi-Fi.

Something else

Open a thread on GitHub Discussions or browse the Changelog to see if it was a known issue in a recent build.