homebridge-myhomeautomation

Homebridge plugin for myHomeAutomation Flask API.

Registers three components in a single plugin:

| Component | Type | HomeKit Services | |---|---|---| | MainDoor | Accessory | 🔒 LockMechanism (Nuki) + 🚪 ContactSensor (Meraki MT) | | ContactSensors | Platform | 🚪 ContactSensor × n (doors / windows) | | AuroraHood | Accessory | 🌀 Fan + 💡 Main Light + 💡 Ambient Light |

Installation

npm install -g homebridge-myhomeautomation

Configuration

Add to your Homebridge config.json:

{
  "accessories": [
    {
      "accessory": "MainDoor",
      "name": "Haustür",
      "apiBase": "http://172.24.4.5:8004",
      "pollInterval": 5
    },
    {
      "accessory": "AuroraHood",
      "name": "Dunstabzug",
      "apiBase": "http://172.24.4.5:8004",
      "pollInterval": 10
    }
  ],
  "platforms": [
    {
      "platform": "ContactSensors",
      "name": "Tür-Sensoren",
      "apiBase": "http://172.24.4.5:8004",
      "pollInterval": 5,
      "sensors": [
        { "name": "Terrasse", "key": "terrace" },
        { "name": "Keller",   "key": "basement" }
      ]
    }
  ]
}

MainDoor

| Option | Type | Default | Description | |---|---|---|---| | accessory | string | – | Must be "MainDoor" | | name | string | "Main Door" | HomeKit display name | | apiBase | string | "http://localhost:8004" | Flask API URL | | pollInterval | number | 5 | Poll interval in seconds |

ContactSensors

| Option | Type | Default | Description | |---|---|---|---| | platform | string | – | Must be "ContactSensors" | | apiBase | string | "http://localhost:8004" | Flask API URL | | pollInterval | number | 5 | Poll interval in seconds | | sensors[].name | string | – | HomeKit display name | | sensors[].key | string | – | Key from /door-status ("terrace", "basement", …) |

AuroraHood

| Option | Type | Default | Description | |---|---|---|---| | accessory | string | – | Must be "AuroraHood" | | name | string | "Aurora Hood" | HomeKit display name | | apiBase | string | "http://localhost:8004" | Flask API URL | | pollInterval | number | 10 | Poll interval in seconds |

Fan speed mapping: 25% = low · 50% = middle · 75% = high · 100% = strong

Ambient brightness: 33% = 1 · 66% = 2 · 100% = 3