Homeswift GitHub

Homebridge, rewritten in Swift

Every device, in the Home app.

Homeswift speaks HomeKit for the lights, air conditioners, cameras and locks Apple never certified. One small binary runs your Homebridge config and plugins, with no Node.js and no npm, and idles in under 10 MB.

Get started View source

v0.12.0, early releasemacOS 14+ and LinuxMIT licence

Desk LightOn · 70 %
Brightness70 %
Living RoomHeating to 21.5°
19.5°Inside
21.5°Heat to
60%
Bedroom ShutterOpen · 60 %
Porch LightOn
Coffee MachineOff
Front DoorLocked · hold
PUT/characteristics {"aid":2,"iid":10,"value":true}

A live demo of the bridge's web UI. Tap, drag, or hold the door. Explore the design system →

Performance

Small enough to forget it's running.

The same HomeKit controller drove two bridges with the same 30 lightbulbs: Homeswift, and HAP-NodeJS, the library inside Homebridge.

HomeswiftHAP-NodeJS 2.2.2

Apple M1, macOS 27.0.1, 21 October 2026, one run each over loopback. Lower is better on every row. The full table, with throughput and the rows where HAP-NodeJS uses less CPU per request, is in Benchmarks/README.md.

What's inside

Everything a bridge needs. Nothing it doesn't.

Add it with the code on the label

Pair setup with an 8-digit code over SRP-6a, encrypted sessions on every request, up to 16 controllers. Every accessory keeps its IDs, so rooms, scenes and automations survive restarts.

0052
1956

Your Homebridge config, as is

Reads a Homebridge-style config.json. Plugins keep their platform and option names, child bridges work the same way, and an edit is checked against the plugin's schema before it is saved.

Cameras and doorbells

Live video and snapshots over SRTP, HomeKit Secure Video recording, two-way audio and the doorbell's ring, with FFmpeg doing the encoding.

A web UI shaped like Home

Every accessory is a widget on a wall you arrange. Status, plugins, config, logs and backups sit beside it, behind your own accounts, with two-factor if you like.

An Assistant, if you want one

Ask why a light dropped off, explain a log, or get a daily digest. Optional, with a budget, and everything is redacted before a provider sees it.

Your home in Claude, and other AI apps

An MCP server that claude.ai and the Claude apps add as a connector: you sign in with your web UI account and choose what it may do. Anything destructive asks first, every change is audited, and locks, garage doors and alarms go through one guarded tool.

Runs where your home runs

A container for amd64 and arm64, a Synology package for DSM 7, or a plain binary on macOS 14 and Linux.

Graph

Your whole home, on one page.

The Accessories page draws what Homeswift runs as a map: its bridges, the plugins on each, their device types and every accessory, each plugin in its own colour with its brand's logo.

  • Search a name or a brand, or filter by bridge, device type or what does not answer: the graph lays itself out again around what is left.
  • Click any node for its card: a camera's live picture, a sensor's readings grouped by service, every value explained on hover.
  • Pinch, scroll or click a branch to zoom into it; a table gives the same rows to a screen reader.

Plugins

Fourteen plugins, compiled in.

Ten are ports of the Homebridge plugins you may already use; Philips Hue and IKEA DIRIGERA talk to their bridges on your network; Wingman brings in the Home app's own accessories; EcoFlow reads its power stations from EcoFlow's cloud. Each is tested against a fake of its device or cloud.

EK
Elgato Key LightsKey Light, Ring Light
UP
UniFi ProtectCameras, doorbells, sensors
UA
UniFi AccessDoor locks and readers
DC
Daikin CloudAir conditioners
DY
Dyson Pure CoolPurifiers and fans
LG
LG ThinQAppliances
PH
Philips Ambilight TVTelevision, remote
GV
GoveeLights
HU
Philips HueLights, scenes, effects
IK
IKEA DIRIGERALights, outlets, sensors
eW
eWeLinkSonoff switches and plugs
DL
DolphinPool cleaners
EF
EcoFlowPower stations, batteries
WingmanApple Home, through a Mac
+
Port your ownFrom Node.js to Swift, step by step

Install

Running in five minutes.

# amd64 and arm64. Host networking lets HomeKit find the bridge over mDNS.
docker run -d --name homeswift --network host \
  --restart unless-stopped \
  -v ~/homeswift:/homeswift \
  ghcr.io/mp-consulting/homeswift:latest
  1. Open the web UI

    On port 8581 of the machine running the bridge.

  2. Create your account

    With the set-up code the bridge prints when it starts.

  3. Add plugins

    Pick them on the Plugins page and fill in their settings.

  4. Add the bridge in Home

    Scan the QR code on the Status page, or type the 8-digit code.

For developers

A lamp in twenty lines.

  • All 73 services and 252 characteristics HomeKit knows, with their units, ranges and valid values.
  • Swift 6 concurrency: handlers are async, and a thrown error shows as No Response in Home.
  • Set a value when the device changes, and every subscribed Home app updates.
import Homeswift

let light = Service(.lightbulb, name: "Desk Lamp",
                    optional: [.brightness], isPrimary: true)

light.characteristic(.on).onWrite(changesOnly: true) { value in
    try await lamp.setPower(value.boolValue ?? false)
}

let accessory = Accessory(
    id: "desk-lamp", name: "Desk Lamp",
    manufacturer: "Acme", model: "L1",
    category: .lightbulb, services: [light])

let server = try HAPServer(bridge: bridge, accessories: [accessory],
                           storage: FileStorage(name: "my-bridge"))
print("Setup code:", server.setupCode)  // 1234-5678
try await server.run()