0xProbabillity/house-control

选用指南

AI 根据 README 整理 · 2026/10/22 14:01:58

适用场景

适用于在 Mac 菜单栏或 iPhone 上以 3D 模型方式管理家庭灯光和空调的场景，支持通过 Smart Life、Home Assistant、Philips Hue 和 Apple Home 连接真实设备。

查看 README 依据

<p align="center"> <img src="docs/icon.png" width="112" alt="House Control icon"> </p> <h1 align="center">House Control</h1> <p align="center"> Your home as a live 3D model — in the Mac's menu bar, around its notch and on your iPhone —<br> controlling its lights and air conditioners through Smart Life, Home Assistant, Philips Hue and Apple Home. </p> <p align="center"> <a href="#download"><b>Download</b></a> &nbsp;·&nbsp; <a href="#build-and-run"><b>Build it yourself</b></a> &nbsp;·&nbsp; <a href="#support-the-project"><b>Support the project</b></a> </p> <p align="center">

- **Air conditioners.** Power, target temperature, mode and fan speed, with the room temperature from a real sensor if you have one. - **Scenes.** One tap sets every light and AC — "Cozy", "Movie", "Night", or your own. - **A visual editor.** Draw the rooms, drop in furniture, place lamps and ACs, and link each one to a real device. - **Your devices, wherever they live.** Smart Life / Tuya, Home Assistant (and the thousands of brands it runs), Philips Hue and Apple Home — mixed freely in one home. See [Connect real devices](#connect-real-devices).

使用方式

Mac 应用通过菜单栏图标使用，点击图标打开面板，右键图标可访问编辑、配对、AI Access 等选项。iPhone 应用通过触摸操作，如点击、拖动、捏合缩放。

查看 README 依据

**System Settings → General → Login Items**, where it can be switched off too. There is no Dock icon and no main window: look for the house in the menu bar. ## Using it | Do this | To get this | | --- | --- | | Click the menu bar icon | Open or close the panel | | Right-click the menu bar icon | Edit Home, Load Floor Plan, Reveal Plan File, Reveal Device Log, Show Island, Open at Login, Pair iPhone, AI Access, Reload, Quit | | Click a lamp in the 3D view, or its tile | Toggle it | | Drag sideways across a light tile | Dim it |

<img src="docs/iphone.png" width="820" alt="The iPhone app: home, an air conditioner, a colour light and settings"> </p> The iPhone app is the panel made for a thumb: tap a lamp in the 3D view or its tile, drag across a tile to dim, touch and hold a light for brightness and colour, pinch the model to zoom, swipe in from the left edge to go back. It needs no Mac. Everything is set up on the phone, under **Settings** (the sliders button): - **New home** starts your own plan — one room, or the Studio or Apartment layout to adapt — and opens the editor.

部署要求

Mac 版本需要 macOS 13 Ventura 或更新版本，构建时需要 Xcode Command Line Tools (Swift 5.9+) 和 Node.js 20.19+ 或 22.12+。iPhone 应用需要 iOS 17+ 和 Xcode 16+ 进行构建。

查看 README 依据

| macOS | 13 Ventura or newer | | Xcode Command Line Tools | Swift 5.9 or newer — `xcode-select --install` | | Node.js | 20.19+ or 22.12+ | | For the iPhone app | Xcode 16 or newer, [XcodeGen](https://github.com/yonaskolb/XcodeGen) (`brew install xcodegen`), iOS 17+ | ## Build and run ```bash git clone https://github.com/0xProbabillity/house-control.git cd house-control ./scripts/build-app.sh open build/HouseControl.app ``` The script builds the web UI with Vite, the native shell with SwiftPM, and assembles an ad-hoc signed

已知限制

Mac 应用未使用付费 Apple Developer ID 签名，首次启动时 macOS 会阻止运行，需要用户手动允许。

查看 README 依据

because the app is not signed with a paid Apple Developer ID (see [why](#why-the-app-is-not-notarized)). Allow it once: - **macOS 15 Sequoia and newer:** click **Done**, open **System Settings → Privacy & Security**, scroll down to *“House Control was blocked…”*, click **Open Anyway** and confirm with your password. - **macOS 13–14:** Control-click the app in Applications, choose **Open**, then **Open** again. - Or, in Terminal: `xattr -dr com.apple.quarantine "/Applications/House Control.app"`