All Settings

Everything is configured in the iPhone app and syncs to your watch. The Settings tab is organized into six groups: Account & Connection, Watch Settings, Control Center & Status Pages, Notifications, Tools & Automations, and Data & Help.

Account & Connection

Pro / Upgrade — Shows your current status (Pro, Trial with days remaining, or Free Mode). Tap to open the paywall.

Home Assistant — Your server connection and health. The row shows a quick status; tap in for:

Local URL and Remote URL — Your Home Address (same Wi-Fi) and Away Address (when you’re not home). Tap Fill from Home Assistant to auto-detect them from HA’s network settings. See Setup Guide if you haven’t connected yet.
Access Token — A long-lived access token. You can paste one, or sign in with your Home Assistant account and the app mints one for you. (Account sign-in is only used to create the token — it isn’t a separate persistent login mode.)
Connection Status card — A live readout of every link in the chain, each with a tap-for-help ”?” sheet:
- Server — Local or Remote.
- WebSocket — Live-update connection (Connected / Disconnected / Unreachable).
- Integration — The Wrist Assistant integration; tap to re-check its version.
- Phone Integration Key / Watch Integration Key — The HMAC credentials that let each device talk to the integration securely.
- Notifications — Delivery-mode aware; shows a Fast not ready warning if Home Assistant doesn’t yet have your iPhone’s push token (see Notifications → Delivery).
- Watch Paired / Watch App Open — Whether the watch is reachable and the app is running.
Run Setup Check — Launches the Setup Check wizard that walks through every connection, integration, and watch-setup step with one-tap fixes.
Integration Install / Update — Opens the same install flow used during first-run onboarding. If the integration isn’t installed, the sheet guides you through the recommended HACS path or manual install. If a newer integration release exists, the sheet pre-fills the right version so you can update via HACS in place. With HACS, the app can install/update the integration, restart Home Assistant, wait for startup, and add and activate the integration automatically; if Home Assistant needs one last confirmation form, the app hands off to Safari. See Update Banners.

Watch Settings

Two destinations: Watch Behavior and Voice & Speech.

Watch Behavior

Everything that controls how the watch app feels. Organized into five sub-panels: Connection, Interactions, Pages, Rooms, and Camera Settings.

Connection

Server Mode — Auto picks the fastest path. Only switch to Local or Remote for troubleshooting.
Timeout — How long to wait for live updates before falling back to polling (25s–55s). Increase if you see frequent reconnects.

Interactions

Long Press — How long to hold before the entity view or quick menu opens: Super Fast (75ms), Short (150ms), Normal (200ms), Long (300ms), or Extra Long (1s).
Quick Radial Gesture — A shortcut that opens the Quick Radial Menu from inside any entity radial. Choose the trigger (Up/Down x2, Swipe Up/Down, Clockwise) and the speed (Fast, Normal, Slow, Very Slow).
Double-Tap Top Section — Double-tap the page title / top of the watch face to trigger an action. Options: Toggle Aimed Entity (Point Control), Room Jump, Activate Scene, Run Script, Refresh, Next Page, Previous Page, Toggle First Tile, or Disabled. Scene and Script actions can target a specific scene.* / script.* so they work regardless of page.
Double Pinch — What Apple Watch double-pinch does. Same action options as Double-Tap Top Section. Requires Apple Watch Series 9, Ultra 2, or newer.
Motion Gestures — Wrist-twist detection on/off, plus sensitivity (Low/Medium/High with a fine-tune slider). Assign each direction (clockwise / counter-clockwise) to any of the action options above.
Sounds — Tile tap, menu open, slider tick, and confirmation sounds. Master volume 0–100% with presets: Quiet (5%), Medium (30%), Loud (80%), plus Silent. Each sound type can be changed individually.
Slider Speed — Digital Crown speed for brightness / volume sliders: Precise, Normal, or Fast.
Automations: Skip Conditions — Default behavior when triggering an automation.* from the watch. On (default) calls Home Assistant’s automation.trigger with skip_condition: true so actions fire immediately, matching HA’s own default. Turn off to make watch-initiated triggers re-evaluate the automation’s conditions first. Triggers themselves are always bypassed. Per-tile and per-radial-slot overrides live in the Layout Editor.
Pending Animation — Tile bounce while waiting for server confirmation. Can be toggled globally or overridden per entity domain.
Reset View on Exit — When you leave or background the app, close any open control overlays and peeked pages and return to your main page (default on).
Show Entity Name — Show the entity’s name beneath the dial on value controls (thermostat, light, fan, shade, number) so you can confirm which one is open while you’re adjusting it (default on).

Rooms

Full reference in Rooms.

Room Sensor — A Home Assistant entity that reports your current room. Map each room state to a page.
Rooms List — Add, rename, delete, and drag to reorder. Order affects room pickers throughout the app.
Room Intro Card — Configurable per room. Title, subtitle, icon, colors, and duration for the overlay that appears when you enter a room.
Room Quick Jump — Lets you jump to your current room’s page from a gesture such as Double-Tap Top Section, Double Pinch, or Wrist Twist.
Room Auto-Switch — Automatically switch pages when you move between rooms.
Point Control (per-room zones) — Calibrate which direction maps to which entity for each room. The HUD toggle lives in Developer Tools, and tap-to-toggle / live tile options live in the tile editor. See Point Control.

Camera Settings

Organized into Streaming, Snapshot Loading, Refresh, and Gestures:

Stream Settings — The streaming mode (Live or Snapshots) plus the Fallback Refresh rates. Leave it on Live for smooth real-time video — it adapts to your connection and automatically falls back to snapshots if a camera can’t stream. Choose Snapshots to show periodic stills instead, for setups where live video has trouble. Fallback Refresh is the snapshot interval (used in Snapshots mode, and whenever Live falls back), with separate Standard and HD rates (0.5s, 1s, 2s, 3s, 5s).
Load At Once — Caps how many camera previews Home Assistant grabs in parallel when a page full of cameras loads, easing the load on busy NVRs. Options range from 1 to 16, or Unlimited (the default). Unlike the other settings here, this is a server-side, installation-wide setting stored by the integration — so the row only appears once the Wrist Assistant integration is reachable and new enough to support it. See Cameras.
Loading Dots — Show per-camera progress dots at the top of the page while cameras load, so you can see exactly which ones are still fetching (default on). See Cameras.
Refresh on Page Open — Refresh camera tiles when a page becomes visible, with Debounce (5s/10s/30s/60s) and Delay (Off/250ms/500ms/1s) options. Override per camera in the Page Editor. See Cameras → Refresh on Page Open.
Swipe Next Camera — Bottom edge swipe in full-screen to jump between cameras. Sensitivity: Off, Low, Medium, High. Loop Cameras wraps back to the first.

In full-screen, zoom uses the Digital Crown and pan uses drag — there’s no separate zoom-slider setting.

Voice & Speech

Defaults used by TTS actions (Speak Message, Pick from List - TTS) and Assist tiles when no explicit value is set on the action. (The destination is titled Voice Defaults.)

Engine — Your text-to-speech engine (Google Translate, Piper, HomeKit Voice, etc.).
Speakers — Which media players get TTS audio by default.
Conversation Agent — Default conversation.* entity used by Assist tiles and Assist slots. Pick an LLM-backed integration (OpenAI, Anthropic, local model, etc.) to route Assist through it. Reset returns to Home Assistant’s built-in Assist route. Per-tile / per-slot overrides live in the Layout Editor.
Manage Phrase Library — The saved phrase list used by Pick from List - TTS quick actions.
Speak Even in Silent Mode — Assist replies play through the watch speaker even when Silent Mode is on.

Per-action overrides (output target, speech volume, immediate listen, auto-send, voice broadcast options, conversation agent) live on each tile, radial slot, or quick action — see Voice.

Control Center & Status Pages

Watch Control Center

A master-detail editor for the entities Wrist Assistant exposes through the Smart Stack widget, the Apple Watch Action Button menu, and the watchOS Control Center picker (watchOS 26 and later).

A sticky horizontal tile strip at the top shows everything you’ve added; the selected tile glows. Tap + to add a new entity (Toggle for lights / switches / fans / locks / covers, Action for scenes / scripts / automations) — the picker hides anything you’ve already added so the list stays add-only.
The detail panel below the strip is where you edit the selected tile — change the entity, swap the icon (Suggested / category browser / full picker), tweak label, color, and so on. Tap Remove to delete it from the list. Each row’s subtitle shows the raw entity_id in monospace so HA-side domain mismatches are obvious at a glance.
Entries here power the Smart Stack widget and Action Button menu directly. They also serve as the pickable list when you add a Wrist Assistant Toggle or Action tile from your watch’s Control Center — these tiles aren’t domain-specific, so the picker decides what they actually control.

Status Pages

Create, edit, and reorder status pages — the scrollable home-summary overlays that open from a quick menu slot. Each status page has its own rows (entities, group counts, dynamic lists, section headers) and its own visual style (row style, font, spacing, background material, column layout, dividers, icon position, numeric rounding). Ships with five editable defaults: Lights, Who’s Home, Room Temps, Doors & Windows, Low Battery. Tap the info button in the top corner for an in-app guide including the Siri Shortcut setup steps.

Notifications

The notifications hub gathers everything about Home Assistant’s actionable notifications:

Delivery — Choose Fast (iPhone-mirrored, ~1s, needs your iPhone nearby) or Reliable (sent straight to the watch, works without your phone). See Notifications → Delivery.
Notification Style — Appearance, animation, and sound: background, button fill, button size, corner style, accent color, entity tint, tap animation, state badges, haptics, and sounds. Send a test notification to preview your settings.
Camera Snapshot Framing — Per-camera crops for notification snapshots, with delivery tests and per-camera test sends. See Cameras → Notification Snapshots.

Tools & Automations

Usage Stats — Tile taps, peak hours, most-used domains.

Icon Search — Look up SF Symbol icon names for use in Home Assistant blueprints. Tap an icon to copy its name; long-press to toggle it as a favorite (favorites are shared with the icon picker in the Layout Editor).

HTTP Actions (BETA, Pro) — Build and manage your library of webhooks and REST requests you can fire from a tile, quick menu, complication, or Siri. See HTTP Actions.

Focus Mode Actions — Expandable row. Trigger Home Assistant scenes, scripts, or toggles automatically when an iOS Focus mode activates or deactivates. Setup lives in iOS Settings → Focus → [Focus] → Focus Filters → Add Filter → WristAssistant. A new filter may take a few minutes to run for the first time; after that, it fires reliably on every focus change. See Focus Filters.

Data & Help

Backup & Restore — See Backup & Restore.

Support — Troubleshooting, diagnostics, and feedback. See Support.

About WristAssistant — Version, device, and licenses:

Version — Tap 10 times to unlock Developer Tools.
Discord Community — Opens the community Discord.
Open Source Licenses — Expandable license list.
Privacy Policy — Data collection & usage.
Developer Tools (hidden until unlocked) — HTTP Debug Console, Watch Connection Health, Connection Log, Widget Debug Log, FPS Overlay, Camera Flash, Gesture Debug, HTTP Overlay, plus DEBUG-only premium override and crash testing.

Pro

The paywall is reached from the Account & Connection section’s Pro/Free Mode row, or whenever you tap a gated feature. A single lifetime purchase unlocks seven Pro features:

Multiple Pages — Unlimited watch pages plus Peek Page tiles.
Power Actions — Trigger Entity (scenes, scripts, automations, cross-entity actions), TTS, peek info, and page navigation in radial menus.
Advanced Styling — Animations, patterns, borders, and page themes.
Camera Live Streaming — Full-screen HD streaming, including opening a stream from a notification snapshot tap.
Multiple Complications — More than one complication preset.
Custom Complication Icons — Use the icon display mode on complications.
Unlimited HTTP Actions — Free mode includes one HTTP Action; Pro unlocks an unlimited library (BETA).

Free mode keeps 1 page, 1 complication, 1 HTTP Action, and basic customization (icon customization stays free). Nothing is deleted if the trial lapses — buying Pro later restores everything.

Tile Visibility

Per-tile visibility rules are configured inside the Page Editor, not under Settings. Hidden tiles automatically reflow — the remaining tiles slide up to fill the gap. See Tile Visibility for all the rules — active-only, state-match, numeric comparisons, and cross-entity conditions.

Apple Watch Ultra Action Button

Apple Watch Ultra’s Action Button can’t target third-party apps directly. The supported route is to set the Action Button to Shortcut and pick a Wrist Assistant App Shortcut.

On the watch, open Settings → Action Button → Shortcut.
Pick a Wrist Assistant shortcut. The simplest is Open Wrist Assistant, which just launches the watch app — combine it with the configured action below to make one button press do something useful. Other Wrist Assistant intents (toggle entity, run script, activate scene, etc.) are also pickable directly without opening the app.
Configure what the app does on launch from the watch app’s onboarding or the Interactions panel — toggle a device, activate a scene, run a script, jump to a page, or call any HA service.