Repolode
Submit
0xProbabillity

0xProbabillity/house-control

A menu bar and iPhone app that shows your home as a live 3D model and controls its lights and air conditioners via Smart Life, Home Assistant, Hue and Apple Home.

Open-source alternative to:Apple Home

View on GitHub
Stars
691
Forks
100
Open issues
12
Last commit
5 days ago

What is it?

House Control draws your floor plan as a 3D scene built from a single JSON file, with rooms, walls, doors, windows and furniture. Lamps light the scene and running air conditioners show airflow. You can toggle and dim lights, set colour and white temperature, and adjust AC power, target temperature, mode and fan speed, with one-tap scenes for the whole home.

The app is a native shell (AppKit on macOS, SwiftUI on iPhone) around a Three.js web UI. Devices come from Smart Life / Tuya, Home Assistant, Philips Hue and Apple Home, and can be mixed in one home. Without any sign-in, every device is simulated so the app can be tried first. A visual editor lets you draw rooms and link each lamp or AC to a real device.

The Mac and iPhone apps can be paired over the local network with a QR code and keep the floor plan in sync over TLS, without a server. The project also offers a menu bar island, widgets, and an AI Access mode that exposes lights and ACs to AI assistants through a private link or MCP.

Key features

  • 013D floor plan built from one JSON file, with lamps lighting the scene
  • 02Control lights (toggle, dim, brightness, colour) and air conditioners (power, temperature, mode, fan)
  • 03Connects Smart Life/Tuya, Home Assistant, Philips Hue and Apple Home in one home
  • 04Runs fully simulated without any hardware or sign-in
  • 05Mac and iPhone apps sync over the local network with a QR-code pairing
  • 06Widgets, Lock Screen and Control Center controls on iPhone

Use cases

  • Controlling lights and air conditioners from the Mac menu bar without opening another app
  • Running a home that mixes Hue, Home Assistant and Tuya devices in one interface
  • Giving an AI assistant limited control over home devices through a private link
  • Planning and visualising a floor plan before connecting real hardware

Quick start

  1. 1

    Download the HouseControl DMG from the Releases page

  2. 2

    Clone the repository

    git clone https://github.com/0xProbabillity/house-control.git
  3. 3

    Build the app from the project folder

    cd house-control && ./scripts/build-app.sh
  4. 4

    Open the built app and look for the house icon in the menu bar

    open build/HouseControl.app

Things to know

  • The menu bar app runs only on macOS 13 or newer, and the iPhone app requires iOS 17 or newer.
  • The app is not notarized, so macOS blocks it on first launch and requires a manual approval step.
  • Building from source needs Xcode Command Line Tools and Node.js 20.19+ or 22.12+.

Topics

#smart-home#home-automation#home-assistant#philips-hue#homekit#macos#ios#swift#menu-bar-app#threejs

FAQ

What is house-control?
A menu bar and iPhone app that shows your home as a live 3D model and controls its lights and air conditioners via Smart Life, Home Assistant, Hue and Apple Home. House Control draws your floor plan as a 3D scene built from a single JSON file, with rooms, walls, doors, windows and furniture. Lamps light the scene and running air conditioners show airflow. You can toggle and dim lights, set colour and white temperature, and adjust AC power, target temperature, mode and fan speed, with one-tap scenes for the whole home.
Is house-control free to use? What license does it have?
house-control is open source under the MIT license. Check the license terms before using it in commercial products.
Is house-control still maintained?
Actively maintained. The last commit to house-control was on Oct 16, 2026.
What can I use house-control for?
Controlling lights and air conditioners from the Mac menu bar without opening another app Running a home that mixes Hue, Home Assistant and Tuya devices in one interface Giving an AI assistant limited control over home devices through a private link Planning and visualising a floor plan before connecting real hardware
How do I install house-control?
Download the HouseControl DMG from the Releases page Clone the repository: git clone https://github.com/0xProbabillity/house-control.git Build the app from the project folder: cd house-control && ./scripts/build-app.sh Open the built app and look for the house icon in the menu bar: open build/HouseControl.app
Where can I get house-control?
The source code and installation instructions are on GitHub: https://github.com/0xProbabillity/house-control

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects