All Settings
Everything is configured in the iPhone app and syncs to your watch.
Connection
Section titled “Connection”Server URL and Access Token — Your Home Assistant address and long-lived access token. Supports OAuth sign-in or manual setup with a long-lived token. See Setup Guide if you haven’t connected yet.
Server Mode — Leave on 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.
HACS Integration — The app can auto-install the WristAssistant HACS integration on your server for enhanced features.
Navigation
Section titled “Navigation”Loop Pages — Pages wrap around in a circle so the last connects back to the first. Useful once you have a few pages.
Crown Navigation — Use the Digital Crown to scroll between pages. Sensitivity: Fine, Normal, Coarse.
Edge Swipe — Bottom screen edge swipe to switch pages. Adjustable sensitivity or off.
Page Transition — Animation when switching: Default (push with scale), Slide, Fade, or None.
Page Dots — The row of dots showing which page you’re on. Hide for a cleaner look.
Pull to Refresh — Swipe down to force-refresh all entity states.
Page Title — Show page names. Auto mode fades after a moment. Styles: Minimal, Pill, Glass.
Interaction
Section titled “Interaction”Long Press Duration — How long before controls or quick actions open. If you accidentally trigger long-press often, use Long (300ms). If it feels sluggish, try Super Fast (75ms).
Double-Tap Speed — How fast you need to tap twice. Wider window = easier to trigger but adds a small delay to single taps.
Swap Tap Actions — Flip single-tap and double-tap behavior.
Slider Speed — How fast arc sliders respond to the Digital Crown: Precise, Normal, or Fast.
Pending Animation — The bounce while waiting for server confirmation. Turn off for a more minimal feel.
Sounds
Section titled “Sounds”Sounds for tile taps, menu opens, slider ticks, and confirmations. Master volume (5–100%) with presets: Quiet (20%), Medium (50%), Loud (85%). Each sound type can be changed individually.
Motion Gestures
Section titled “Motion Gestures”Sensitivity — Off, Low, Medium, High, plus a fine-tune slider. Start low, work up.
Twist Clockwise / Counter-Clockwise — Assign each to: next/previous page, brightness or volume up/down, activate a scene, toggle first tile, toggle compass-aimed entity, refresh, or compass toggle.
Hand Gestures
Section titled “Hand Gestures”Hand Gesture Action — What double-pinch does: Disabled, Next Page, Previous Page, Room Jump, Toggle First Tile, Refresh, Compass Control.
Requires Apple Watch Series 9, Ultra 2, or newer.
Room Sensor — A Home Assistant entity that reports your current room. Map each room state to a page.
Room Quick Jump — Triple-tap to jump to your current room’s page.
Room Auto-Switch — Automatically switch pages when you move between rooms.
Compass — HUD overlay, tap-to-toggle, live compass tile. See Compass Control.
Camera
Section titled “Camera”Stream Mode — Auto, Smart Stream (fastest), MJPEG, or Polling.
Refresh Rates — Separate for standard and HD (0.5s to 5s). 2–3 seconds for everyday use.
Zoom Slider — Left side, right side, or off.
Camera Swiping — Bottom edge swipe in full-screen to jump between cameras. Loop Cameras wraps back to the first.
TTS Engine — Your text-to-speech engine (Google Translate, Piper, HomeKit, etc.).
Default Speakers — Which media players get TTS audio.
Quick Phrases — Up to 8 tappable shortcuts on the voice screen.
Notifications
Section titled “Notifications”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.
Watch Control Center
Section titled “Watch Control Center”Which entities appear in the watchOS Control Center (watchOS 26+). Toggle buttons for lights, switches, fans, locks, covers — action buttons for scenes, scripts, automations.
Apple Watch Ultra
Section titled “Apple Watch Ultra”Configure the Action Button to trigger commands when the app is open — toggle a device, activate a scene, run a script, jump to a page, or call any HA service.
Developer Tools
Section titled “Developer Tools”Hidden by default — tap the version number in About 10 times to unlock. HTTP debug overlay, gesture debug, FPS counter, and other diagnostics. Also where you can disable anonymous analytics (PostHog).