homecast

Control your Apple HomeKit smart home from any browser, REST API, or AI assistant — running entirely on your Mac with no cloud dependency.

<p> <a href="https://github.com/parob/homecast/actions/workflows/ci.yml"></a> <a href="https://apps.apple.com/us/app/homecast-app/id6759559232?platform=mac"></a> <a href="https://homecast.cloud"></a> <a href="https://docs.homecast.cloud"></a> <a href="LICENSE"></a> </p>

Download from the Mac App Store. Launch the app, select Community on the mode selector, and you're ready to go.

Prerequisites: macOS 13+, Xcode 15+, Node.js 18+

# Clone both repos
git clone https://github.com/parob/homecast.git
git clone https://github.com/parob/homecast-web.git homecast/app-web

# Build the web app
cd homecast/app-web
npm install && npm run build

# Bundle into the Mac app
cd ../app-ios-macos
./scripts/bundle-web-app.sh

# Open in Xcode and build
open Homecast.xcodeproj
# Build for: My Mac (Mac Catalyst)

> Note: HomeKit requires a valid Apple Developer account with the com.apple.developer.homekit entitlement. App Store distribution is required — Developer ID builds won't work.

• Control from any browser — open http://your-mac.local:5656 on your phone or tablet
• REST API — GET /rest/homes, GET /rest/accessories, POST /rest/state
• **