A native macOS menu bar app for controlling your HomeKit and Home Assistant smart home.

itsyhome.app

iOS	tvOS

• Menu bar access - Control your smart home from the macOS menu bar
• HomeKit support - Full integration with Apple HomeKit devices and scenes
• Home Assistant support - Connect to your Home Assistant server via WebSocket API
• Device groups - Create custom groups to control multiple devices at once
• Scenes - Execute and toggle scenes with automatic state tracking
• Favourites - Pin frequently used devices, scenes, and groups to the top of the menu
• Multi-home support - Switch between multiple HomeKit homes (HomeKit only)
• Native experience - Built with AppKit for a true macOS look and feel
• Menu bar pinning - Pin rooms, devices, scenes, or groups as separate menu bar items with optional keyboard shortcuts
• iCloud sync - Sync favourites, groups, and settings across your Macs (Pro)
• Deeplinks - Control devices from Shortcuts, Alfred, Raycast, Stream Deck (Pro)
• Cameras - Live video feed with overlay action buttons to control nearby accessories (Pro)
• Doorbell notifications - Automatic camera view with live stream when a doorbell rings (Pro)
• Sensors - Contact, motion, occupancy, leak, smoke, CO and CO2 sensors as read-only rows, with battery indicators and pinnable menu bar readings
• Webhooks/CLI - Built-in HTTP server with a dedicated CLI tool (Pro)
• Event stream (SSE) - Real-time device state changes via Server-Sent Events for external automation (Pro)
• Virtual HomeKit sensors - Publish Itsyhome's own bridge to Apple Home with virtual sensors, driven by webhooks or built-in automations (Pro)
• Sensor history - 30-day charts for temperature, humidity and binary sensors, right in the menu (Pro)
• Itsytv - Free companion app for controlling Apple TV from your menu bar

Connects via WebSocket API for real-time updates. On first launch, choose your platform. Switch anytime in Settings → General.

Setup: Profile → Security → Long-Lived Access Tokens → Create token → Enter server URL and token in Itsyhome settings.

Notes:

• Entities are automatically grouped by device and area
• Cameras require the stream integration for live video
• Scene state tracking requires scenes created in the Home Assistant UI (not YAML)

View live video feeds from your cameras directly in the menu bar. Supports HomeKit cameras and Home Assistant cameras with WebRTC streaming. Overlay action buttons let you control nearby accessories without leaving the camera view — toggle lights and outlets, open garage doors and gates, or lock and unlock doors.

When a doorbell rings, the camera panel automatically opens in the top-right corner of the screen with a pinned live stream of the doorbell camera. Supports HomeKit doorbells and Home Assistant doorbell events. A configurable chime sound plays on ring. Both the automatic camera display and the sound can be independently toggled in Settings → Cameras.

Itsyhome can publish its own bridge to Apple Home over HAP, carrying read-only virtual sensors (contact, motion, occupancy, leak, smoke, CO, CO2). Manage them in Settings → HomeKit bridge and pair by scanning a QR code (or typing the setup code); pairings and the bridge identity persist across restarts, with the identity key stored in the Keychain. Sensor state is set by name through the regular webhook verbs, or by built-in automations: "WHEN a HomeKit accessory holds a state FOR a duration THEN set a virtual sensor", with optional re-pulsing - so Apple Home can automate on conditions HomeKit can't compute itself, like "door open for 15 minutes". HomeKit mode only.

Opt-in 30-day history for every sensor, shown as a chart in the sensor's submenu: a line for temperature and humidity (thermostat and AC current temperature included), an on/off timeline for binary sensors, with hover readout and a 24h/7d/30d range toggle. Captured off the existing update path - no extra polling - and stored locally per home. Periods when nothing was recording (app closed, Mac asleep) show as gaps in the chart. Enable it in Settings → Advanced.

Sync your favourites, hidden items, device groups, shortcuts, and pinned items across all your Macs.

Control your smart home devices from external apps using URL schemes. Perfect for Shortcuts, Alfred, Raycast, Stream Deck, and other automation tools. Works with both HomeKit and Home Assistant.

URL format:

itsyhome://<action>/<target>

Actions:

Target formats:

• Room/Device - Device in specific room (e.g., Office/Spotlights)
• Room/group.Name - Group scoped to a room (e.g., Office/group.All%20Lights)
• group.Name - Global group (e.g., group.Office%20Lights)

Testing from terminal:

open "itsyhome://toggle/Office/Spotlights"
open "itsyhome://toggle/Office/group.All%20Lights"
open "itsyhome://toggle/group.Office%20Lights"
open "itsyhome://scene/Goodnight"
open "itsyhome://brightness/50/Bedroom/Lamp"

Note: Spaces in room or device names must be URL-encoded as %20.

A built-in HTTP server that lets you control and query your smart home devices from any tool on your network — terminal, scripts, other apps, or the dedicated itsyhome CLI. Works with both HomeKit and Home Assistant.

Enable the server in Settings → Webhooks/CLI. Default port: 8423. The server can optionally be bound to a single interface address (e.g. a Tailscale mesh IP) so it's reachable over a private network only.

Control endpoints:

curl http://localhost:8423/toggle/Office/Spotlights
curl http://localhost:8423/on/Kitchen/Light
curl http://localhost:8423/off/Bedroom/Lamp
curl http://localhost:8423/brightness/50/Office/Lamp
curl http://localhost:8423/position/75/Living%20Room/Blinds
curl http://localhost:8423/speed/50/Bedroom/Ceiling%20Fan
curl http://localhost:8423/temp/22/Hallway/Thermostat
curl http://localhost:8423/heat/19/Hallway/Thermostat        # heating threshold (auto-mode)
curl http://localhost:8423/cool/23/Hallway/Thermostat        # cooling threshold (auto-mode)
curl http://localhost:8423/mode/auto/Hallway/Thermostat      # off | heat | cool | auto | heat_cool | dry | fan_only
curl http://localhost:8423/color/120/100/Bedroom/Light
curl http://localhost:8423/scene/Goodnight                   # activate scene
curl http://localhost:8423/off/scene/Goodnight               # deactivate scene (Apple Home semantics)
curl http://localhost:8423/lock/Front%20Door
curl http://localhost:8423/unlock/Front%20Door
curl http://localhost:8423/open/Garage/Door
curl http://localhost:8423/close/Bedroom/Blinds
curl http://localhost:8423/arm/stay/Hall/Alarm
curl http://localhost:8423/arm/away/Hall/Alarm
curl http://localhost:8423/arm/night/Hall/Alarm
curl http://localhost:8423/disarm/Hall/Alarm
curl http://localhost:8423/refresh

Query endpoints:

List responses respect the user's drag ordering from Settings → Accessories, and hidden items are filtered out (a specific /info/<name> lookup still works for hidden items).

Event stream (SSE):

Stream real-time device state changes using Server-Sent Events. Connect with curl -N or any SSE client (including EventSource in browsers). Only actual value changes are emitted — read refreshes are filtered out.

curl -N http://localhost:8423/events

Each event is a JSON object on a data: line:

data: {"characteristic":"brightness","characteristicId":"ABC-123","device":"Desk Lamp","entityId":"light.desk_lamp","room":"Office","serviceId":"DEF-456","timestamp":"2026-02-09T14:30:00Z","type":"light","value":75}

Multiple clients can connect simultaneously. A : heartbeat comment is sent every 15 seconds to keep connections alive.

Response format:

{"status": "success"}
{"status": "error", "message": "device not found"}

CLI tool:

Install the dedicated CLI for a better terminal experience:

brew install nickustinov/tap/itsyhome

See itsyhome-cli for full documentation.

Control your smart home devices directly from an Elgato Stream Deck using the Itsyhome Stream Deck plugin. Works with both HomeKit and Home Assistant. Requires the webhook server to be enabled.

Actions:

Features include color-coded icons per device type, dynamic state display, live state polling, optimistic updates for slow devices (locks, garage doors), custom on/off colors, and optional labels for multi-button setups.

Source code: itsyhome-streamdeck

Itsyhome is available on Even Realities G2 smartglasses. Control your home hands-free, using the R1 smart ring or your voice: browse rooms with a swipe, toggle lights with a tap, adjust the thermostat – every accessory and group in your house, right from the temple touchpad.

Control your smart home with natural language via OpenClaw. The itsyhome-control skill connects your AI agent to the webhook server, enabling commands like "turn off the living room lights" or "set bedroom brightness to 40%". Requires the webhook server to be enabled.

clawhub install itsyhome-control

Itsytv is a free, open-source macOS menu bar app for controlling Apple TV — the missing remote app for your Mac. Full D-pad and playback remote Now playing widget with live progress Browse and launch Apple TV apps Keyboard shortcuts for quick control Text input for searches and passwords Multi-device support End-to-end encrypted, no tracking Built with Swift and SwiftUI. Free forever, MIT licensed. itsytv.app · GitHub

• macOS 14.0 or later
• Xcode 15.0 or later
• XcodeGen for project generation
• Apple Developer account with HomeKit entitlement (for HomeKit mode)
• Home Assistant server with long-lived access token (for Home Assistant mode)

HomeKit mode:

1. The Catalyst app initializes HomeKit and monitors for device updates
2. Device data is serialized to JSON and passed to the macOS plugin
3. The plugin renders custom NSMenuItem views with controls
4. User interactions are sent back to the Catalyst app to execute HomeKit commands

Home Assistant mode:

1. The macOS plugin connects directly to Home Assistant via WebSocket
2. Entity states are fetched and mapped to the common MenuData format
3. Real-time state changes are received via WebSocket subscriptions
4. User interactions call Home Assistant services directly via the REST API

Startup diagnostics logging can be enabled by setting StartupLogger.enabled = true in macOSBridge/Utilities/StartupLogger.swift. Logs are emitted via os_log with subsystem com.nickustinov.itsyhome and category Startup, viewable in Console.app or via:

log stream --predicate 'subsystem == "com.nickustinov.itsyhome"' --level info

Home Assistant debugging:

For local testing without real hardware, run the Home Assistant demo:

docker run -d --name homeassistant -p 8123:8123 ghcr.io/home-assistant/home-assistant:stable

Then navigate to http://localhost:8123, create an account, and generate a long-lived access token.

When the webhook server is running, these debug endpoints are available:

Example using curl:

curl http://localhost:<port>/debug/all
curl http://localhost:<port>/debug/Living%20Room%20Light
curl http://localhost:<port>/debug/raw
curl http://localhost:<port>/debug/cameras
curl http://localhost:<port>/debug/cameras/camera.front_door

MIT License © 2026 Nick Ustinov - see LICENSE for details.

Nick Ustinov

• Email: nick@ustinov.cc
• Website: itsyhome.app
• GitHub: @nickustinov

• Website: itsyhome.app
• Issues: GitHub Issues

Contributions are welcome! Please feel free to submit issues and pull requests.