All Settings

Everything is configured in the iPhone app and syncs to your watch. The Settings tab is organized into four groups: Account, Watch Settings, Other, and About.

Account

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

Home Assistant — Your server connection. Shows the current connection status (Connected, Connecting…, Disconnected, Auth failed, Not configured). Inside:

• Server URL and Access Token — Long-lived token or OAuth sign-in. See Setup Guide if you haven’t connected yet.
• Integration Install — Opens the same install flow used during first-run onboarding. If the Wrist Assistant integration is not installed yet, the sheet can guide you through either the recommended HACS path or the manual install path. With HACS, the app can install the integration, restart Home Assistant, wait for startup, and then try to add and activate the integration automatically. If Home Assistant needs one last confirmation form, the app hands off to Safari for that final step. Manual install remains available at all times and finishes by re-checking directly for the Wrist Assistant integration, without requiring HACS.

Watch Settings

This group has five destinations: Watch Behavior, Watch Control Center, Status Pages, Speakers & TTS, and Notification Style.

Watch Behavior

Everything that controls how the watch app feels. Organized into five sub-panels:

Connection

• Server Mode — Auto picks the fastest path. Only switch to Local or Remote for troubleshooting.
• Delta 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).
• 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.

Navigation

• Page Transition — Animation when switching: None, Slide, Fade, or Default. New installs start with None for maximum snappiness.
• Page Dots — The row of dots showing which page you’re on. Hide for a cleaner look, or customize style when visible.
• Pull-Down Action — What a swipe down from the top of a page does: Refresh, Next/Previous Page, Room Jump, Activate Scene, Run Script, Toggle First Tile, or Disabled.
• Loop Pages — Pages wrap around so the last connects back to the first.
• Edge Swipe — Bottom screen edge swipe to switch pages. Adjustable sensitivity (Low / Medium / High / Max) or off.
• Popup Background — Material blur used behind tile control overlays: Ultra Thin, Thin, Regular, Thick, or Ultra Thick.

Per-page style (title style, background image, reflow mode, theme) lives in the Page Editor, not here — see Layout Editor.

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

• Stream Mode — Auto, Smart Stream (fastest), MJPEG, or Polling. Leave on Auto unless troubleshooting — Auto cascades through Smart Stream → MJPEG → Polling based on what each camera supports.
• Fallback Refresh — Polling interval when streaming is unavailable. Separate Standard and HD rates (0.5s, 1s, 2s, 3s, 5s).
• 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.

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.

Speakers & TTS

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

• 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.

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.

Notification Style

Style for Home Assistant’s actionable notifications on the watch — 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.

Other

Backup & Restore — See Backup & Restore.

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).

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.

About

• Version — Tap 10 times to unlock Developer Tools.
• What’s New — Expandable changelog.
• Troubleshooting Guide — Opens the online troubleshooting docs.
• Feedback & Support — Opens the GitHub issue tracker.
• 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 section’s Pro/Free Mode row, or whenever you tap a gated feature. A single lifetime purchase unlocks six Pro features:

• Multiple Pages — Unlimited watch pages plus Peek Page tiles.
• Power Actions — Scenes, scripts, TTS, peek info, and page navigation in radial menus.
• Advanced Styling — Animations, patterns, borders, groups, and page themes.
• Camera Live Streaming — Full-screen HD streaming and multi-cam views.
• Multiple Complications — More than one complication preset.
• Custom Complication Icons — Use the icon display mode on complications.

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

Tile Visibility & Reflow

Per-tile visibility rules and per-page reflow are configured inside the Page Editor, not under Settings. 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.

1. On the watch, open Settings → Action Button → Shortcut.
2. 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.
3. 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.