ControlZ app icon
ControlZ Smart Home Control

Unified Smart Home Control

Version 2.0.10 · Build 719 · Updated September 26, 2026

Native SwiftUI app for iPhone, iPad, and Mac — Philips Hue, Conbee/deCONZ, MQTT/Zigbee2MQTT, HomeKit, Home Assistant, and HomeSeer HS4, with DoorBird and HomeKit video, Sonos, AirPlay Announcements (TTS) in Automations and Scenes, Open-Meteo weather (AU BoM severe warnings), automation, security zones, Web Dashboards, Mac Menu Bar scenes, backup, and an optional local HTTP + WebSocket API.

Current TestFlight release — Version 2.0.10 (Build 719)

Build 719: Apple Watch companion on Swift 6.4 with WatchConnectivity isolation so phone sync of scenes, devices, and rooms stays reliable. Aligned on 2.0.10.

How it works

Whole home to local API

Control rooms and devices on-device, then optionally expose a local hub API.

  1. Whole home

    Connect bridges and services you already run — Hue, Conbee/deCONZ, MQTT/Zigbee2MQTT, HomeKit, Home Assistant, HomeSeer HS4, DoorBird, and Sonos — in one ControlZ workspace.

  2. Groups & rooms

    Organize by room, pin a startup room or custom view, manage illumination and window-covering groups, and use All Rooms or bridge-aware dashboards on larger screens.

  3. Devices

    Control lights, blinds, switches, and sensors; run scenes and automations with optional AirPlay or Sonos announcements; monitor Low Battery and Sensor Reports; and keep security zones at a glance.

  4. Local API / hubs

    Enable the embedded HTTP + WebSocket server — typically as a Mac Catalyst hub, or on iPhone/iPad while the app is foreground — for REST control and live updates on your LAN.

Features

Powerful Features

Everything you need to control your smart home with ease

💡

Light Control

Control brightness, color temperature, and RGB colors for all your smart lights. Support for dimming, scenes, and room-wide control.

🪟

Window Covering Management

Open, close, and position your smart window coverings (blinds, shades) with precision. Control speed and direction for smooth operation.

📡

Sensor Monitoring

Monitor motion, temperature, humidity, light levels, and battery in real time. Open Sensor Report for Simple, By Type, By Sensor, and Low Battery views, with presentation-only copy/export.

🔋

Low Battery Report

When any sensor reports battery below 20%, a main-header control appears after devices load. Tap it (or use Sensor Report → Low Battery) for a clean name / room / reading list you can share.

🎬

Scenes & Automation

Create ControlZ scenes, schedules, sensor and switch automations, geofence actions, and one-shot runs. Add AirPlay or Sonos TTS announcements in Automations, Advanced Events, Time Schedules, and Scene options. Hue, HomeKit, Conbee/deCONZ, Zigbee2MQTT, and Home Assistant scene catalogs are presented together where supported.

🏠

Room Organization

Organize devices by room, import or exclude source rooms per bridge, hide empty rooms, pin a startup room or custom view, and choose vertical or horizontal room strips on larger displays.

⏰

Time Schedules

Run scenes on days and times, at solar events, or once at an absolute time or relative offset. Prefer your Mac hub as the automation authority so schedules keep running; author full automation rules on Mac.

🎛️

Switch Control

Configure supported Zigbee/MQTT and HomeKit buttons and remotes to trigger scenes and actions, including presses, double-taps, and long-press mappings where the device exposes them.

🎨

User Custom Views

Create custom grid layouts mixing lights, window coverings, sensors, and rooms. Lock for read-only mode or unlock to edit, reorder, and assign devices. Set as startup view for instant access.

⚙️

User Preferences

Customize device settings including default brightness, favorites, hidden devices, and room assignments. Configure window covering speed, direction, and delays for personalized control.

🌐

Local HTTP API & WebSocket

When the embedded server is enabled, expose REST endpoints for bridges, rooms, scenes, devices, automation, security, weather, and more. Subscribe to WS /ws for live device and log updates (JSON or MessagePack). Authenticate with X-API-Key or query parameters; localhost can bypass keys per server settings. Display URL links (Localhost / Network IP / Both) control which address(es) appear in settings and the green banner.

🔒

Security & zones

Organize locks, doors, motion, presence, smoke, and mixed-device zones; reorder tiles or drag devices across zones; choose which devices affect summaries; and use full-window header/footer status strips (edge-to-edge under the room sidebar on iPad/Mac) plus /api/security/* reports. HomeKit lock/door/motion refresh keeps the Security strip from lingering on stale “SECURE” while tiles show unlocked. ControlZ provides limited status reporting only—it is not a certified alarm system.

🛰️

Integrations

Home Assistant OAuth or long-lived tokens, HomeKit discovery (including video paths), Open-Meteo forecasts with WeatherKit or AU BoM severe warnings, DoorBird stations, HS4 webhooks, and bridge-specific scene and automation catalogs. Client Sync and Browser Companion remain on hold—not retail defaults.

🎙️

Apple Shortcuts & Siri

App Intents and Siri phrases for scenes and device control from Shortcuts. Setup, built-in phrase templates, and limits are available in the in-app documentation when you use ControlZ from the App Store or TestFlight build.

⌚

Apple Watch

Optional watchOS companion: scenes and controls chosen on iPhone sync to Apple Watch when the phone app is available. Pair Watch with daily use on iPhone for wrist-level triggers.

🔊

Sonos LAN & Cloud

Discover and register players, browse content, manage playback and groups, save playlists, inspect the coordinator queue, and deliver targeted text-to-speech announcements. Optional Sonos Cloud OAuth adds Control API playback and grouping. Speech rate is shared with AirPlay Announcements.

📢

AirPlay Announcements (TTS)

Speak local TTS on this device’s current system audio route — including AirPlay speakers and HomePods when that route is selected. Configure defaults under Configuration → AirPlay Announcements, or add AirPlay announcement actions in Automations, Advanced Events, Time Schedules, and Scenes (after device steps). Choose speakers via the Speaker output sheet or Control Center; Apple does not allow silent per-HomePod targeting, so prefer a Mac hub with a stable AirPlay route for unattended events. Ship as beta.

💾

Backup, Restore & iCloud

Create and share .controlzbackup files, restore configuration, schedule local-folder or iCloud snapshots, set count/age retention, and optionally password-protect local backup files.

📈

Performance Advisor

Startup Health, per-bridge load profiles, suggested bridge order, P50 history, warm-return tracking, and regression flags help tune large installations. Bridge load tiers avoid full inventory work when a state refresh is enough.

🧰

Diagnostics & Recovery

Bridge Console connection tools, state refresh, device reload, Local Network guidance, HomeKit identity repair and Home Cleanup, Security orphan repair, and data-health reports provide recovery without rebuilding the whole setup.

👥

User Access Control

Optional native-app and web/API sign-in, role-based permissions, API keys, bootstrap recovery using device authentication, and separate policy controls for local users and integrations.

🧩

Groups & Web Dashboards

Manage illumination/outlet groups, window-covering groups and libraries, cross-bridge Window Coverings dashboards, custom grids, All Rooms views, and Mac-hosted Web Dashboards (Cards or Floor plan with Map pins, Preview / Live / Kiosk).

🧭

Demo Mode & Training

Isolated showroom with preference stovepipe, Training Manual, Show Me Auto/Loop/playlist, wizard skip, and Mac Demo auto-relaunch so demos never write into production stores.

Platforms

Three platforms, one app

ControlZ is built for iPhone, iPad, and Mac (Mac Catalyst). Core bridges and rooms work everywhere; automation depth, layout, and background behavior follow each form factor.

iPhone Pocket

  • Everyday control — rooms, lights, blinds, sensors, scenes, switches, and security views tuned for a single-column, thumb-friendly layout.
  • Automation — Configuration → Automation on iPhone is a scaled-down surface: geofence automations, Schedules, Scenes, HomeKit, and Logs. Full time, sensor, switch, and weather builders stay on Mac; iPhone does not run those full automation runners.
  • Geofence monitoring — Core Location geofence enter/exit/dwell monitoring runs on iPhone only and needs Always location access. You can edit geofence automations elsewhere; they execute when an enabled iPhone monitors the regions.
  • Lifecycle — iOS may pause bridge streams in the background; deferred SwiftData flushes use protected background time so suspension cannot occur while the local store is locked. Bring ControlZ to the foreground for live updates; the embedded API can also run while the app is open.

iPad Canvas

  • Room to breathe — wider grids, more tiles per row, full-window Security/status footer chrome under the room sidebar, and vertical or horizontal room-strip layouts for wall-mount or table use.
  • Scenes control — same Automation surface as iPhone (Schedules, Scenes, HomeKit, Logs) without geofence. Full Automation editors, Switch Design, and Web Dashboards stay on Mac. Not a retail always-on runner.
  • Geofence — region monitoring remains an iPhone responsibility; author geofence rules on iPhone or Mac.
  • Same bridges — Hue, Conbee, MQTT/Z2M, HomeKit, Home Assistant, and HS4 behave the same as on iPhone where enabled; you get more screen for security zones, custom views, and multi-room overview.

Mac Catalyst · Hub

  • Desktop + pointer — windows, menus, and precision control on Mac Catalyst; ideal for long sessions, bulk setup, and troubleshooting.
  • Always-on bridges — on Mac Catalyst, bridge streams (Hue SSE, Conbee WebSocket, MQTT) are kept alive in the background so the app stays current and the embedded web server remains useful as a local API endpoint when you run server mode.
  • Close window, keep serving — on Mac Catalyst, the red close button can hide the window while bridges, automations, and the local web server continue; click the Dock icon to reopen or use ⌘Q to quit fully.
  • Menu Bar scenes — optional ControlZ Menu Bar companion runs favourited scenes without stealing focus; Start from Automation, Tools, or System Preferences → Scenes.
  • Automation + hub — full AutomationV2 runtime (retail always-on authority). Leave “Run automations on this device” On on one Mac hub; keep secondary Macs Off. For unattended AirPlay TTS, keep the desired AirPlay speakers selected on that Mac hub.

Summary: Use iPhone for quick control, scenes, and geofence monitoring; iPad for large-screen Scenes control; Mac Catalyst as the always-on automation + local HTTP hub. Open the Mac hub from iPhone/iPad Safari via Mac Web Server settings. Cross-platform browser companion remains on hold.

Screenshots

See It In Action

Live ControlZ UI from recent App Store / device captures — Automations, Scenes, Security, and sensors.

ControlZ runs on iPhone, iPad, and Mac. Portrait tiles use CSS phone frames; landscape tiles use tablet frames. See Platforms for Automation V2, Web Dashboards, AirPlay TTS, and Mac Web Server access.

ControlZ Automations grid with Movie Time, Secure House, roller doors, and Scene Preferences

Automations grid

Browse ControlZ and Preset automations as a tile grid — Scene Preferences, + Automation, and room sidebar on iPhone.

iPhone · CSS phone frame
ControlZ Automations list with Run actions, System filter, security banner, and motion strip

Automations list

List view with Run, search, System filter, Security banner, and live motion / sensor footer strips.

iPhone · CSS phone frame
ControlZ Create Scene Select Devices sheet with Enabled for Automation toggle over Scene Library

Create Scene

Scene Library → New Scene → Select Devices, with Enabled for Automation. Scene options also host AirPlay / Sonos announcements (after device steps).

iPhone · CSS phone frame
ControlZ Automation and Scheduling on iPhone showing geofence Automations tab and Scenes count

Automation & Scheduling (iPhone)

iPhone surface for geofence automations, Scenes, HomeKit, and Logs — full Event / schedule / AirPlay TTS builders stay on Mac.

iPhone · CSS phone frame
ControlZ Security room with locks, doors, and zone status

Security zones

Native security overview — doors, locks, motion, and zone status with live HomeKit refresh so the strip stays honest.

iPhone · CSS phone frame
ControlZ Sensor Report Sensor Preferences with zone assignment dropdown

Sensor Report & Low Battery

Simple / By Type / By Sensor / Low Battery / Sensor Preferences — assign zones, favourites, and share name / room / reading only.

Mac · CSS tablet frame
ControlZ bridge-specific dashboard with rooms and device tiles

Bridges & rooms

Bridge-aware dashboards for Hue, Conbee/deCONZ, MQTT/Zigbee2MQTT, HomeKit, Home Assistant, HS4, DoorBird, and Sonos.

Mac · CSS tablet frame
Browser window showing ControlZ local server URL and API endpoints table

Web console & Security

Browser UI at controlz.html and security.html on the same host as the API. Display URL links control Localhost / Network IP / Both.

Mac (Safari) · CSS tablet frame
ControlZ Simple Event Actions THEN: AirPlay announcement with speaker output, custom speech rate, and volume next to a Sonos TTS step

AirPlay Announcements (TTS)

Simple Event Actions (THEN): mix Sonos and AirPlay TTS in one event. AirPlay plays on this device’s current audio route — pick speakers in the Speaker output sheet / Control Center; optional custom speech rate and announcement volume.

Mac · CSS tablet frame
ControlZ Kiosk dashboard view

Kiosk / Web Dashboard

Mac-hosted Web Dashboards (Cards or Floor plan) for wall / kiosk viewing — Preview, Live, and Kiosk modes.

iPhone Safari · CSS phone frame

Bridges

Supported Bridges

Works with the most popular smart home bridges

Philips Hue

Full support for Hue v2 API with color control, scenes, and room management

Conbee / deCONZ

Compatible with Conbee and deCONZ bridges for Zigbee device control

MQTT / Zigbee2MQTT

MQTT (including WebSocket transport) with real-time device updates

HomeKit

HomeKit accessories and scenes; web panel at homekit.html plus GET /api/homekit/*

HomeSeer HS4

HomeSeer HS4 JSON API and ControlZ Export plugin path; device sync and POST /api/hs4/webhook for automation hooks. Download ControlZ Export for HS4.

Home Assistant

OAuth or long-lived-token sign-in, devices and source rooms, plus scenes, scripts, and automations exposed in ControlZ management and automation views

DoorBird & Sonos

DoorBird door-station integration and Sonos LAN/cloud playback, grouping, browse, playlists, queue, diagnostics, and announcements

Local API

Local API highlights

When the embedded web server runs in ControlZ—typically as a Mac Catalyst hub, and also on iPhone/iPad while the app remains in the foreground—REST under /api/* and WS /ws share the same host and port as the built-in browser UI.

Core reads

GET /api/health, /api/config, /api/logs, /api/bridges, /api/bridges/queues, /api/rooms, /api/scenes, /api/devices, /api/devices/live (supports incremental ?since=), /api/switches

Control & scenes

PUT|POST /api/devices/{id}/state, PUT|POST /api/bridges/{id}/state, PUT|POST /api/rooms/{id}/state, POST /api/scenes/{id}/execute, POST /api/scenes (push scenes)

Automation & sync

GET /api/automation/time-schedules, sensor-scenes, sensor-groups, switches; POST …/{uuid}/execute for schedules and sensor scenes; GET /api/sync/* and POST /api/sync/broadcast

Keys & realtime

POST /api/keys, GET /api/keys, GET /api/keys/me, PUT|DELETE /api/keys/{id}; WS /ws (use apiKey query when the browser cannot send headers)

HomeSeer HS4

ControlZ Export for HomeSeer HS4

Install this plugin on your HS4 box, then enable Use ControlZ Export plugin in ControlZ. Configure device overrides, room conversion, and export categories in HS4 under Plugins → ControlZ Export.

Latest: 1.2.11.17. Extract into your HomeSeer program folder, rename updater_override.json.sample → updater_override.json, then Plugins → Add → install ControlZ Export → Enable under Manage. Delete updater_override.json and the versioned plugin zip after install. Stable URL: https://brien.com.au/apps/ControlZExport_install_kit.zip

Previous versions / Rollback

Each package is a full install kit for that version (plugin zip + matching override sample + README). Use these to roll back or pin a known-good build.

Ready to Get Started?

Download ControlZ and take control of your smart home today. For support and feedback, use the shared contact page.