Homebridge Multiple Switch

A lightweight Homebridge plugin that lets you create multiple customizable dummy switches in HomeKit. Supports multi-device, master switch, and 14 languages.

Features

• Multi-device support — create multiple separate HomeKit accessories
• Accessory type: switch or outlet
• Independent Mode – All switches operate separately
• Single Mode – Only one switch can be active at a time
• Master Switch (Independent mode) — one switch controls all others
• Per-switch config support (type, auto-off delay, default state)
• Collapsible config UI with dark mode support
• i18n localization (14 languages)
• Homebridge v2 compatible
• Switch states preserved across restarts via cached accessories
• Compatible with HomeKit and Siri

Installation

Install via Homebridge UI:

1. Open Plugins
2. Search for homebridge-multiple-switch
3. Click Install

Or install via terminal:

npm install -g homebridge-multiple-switch

Configuration

Configure from Homebridge UI or manually edit config.json:

{
  "platform": "MultipleSwitchPlatform",
  "name": "Multiple Switch Platform",
  "devices": [
    {
      "name": "Living Room",
      "switchBehavior": "independent",
      "masterSwitch": true,
      "masterSwitchType": "switch",
      "switches": [
        {
          "name": "Lamp",
          "type": "outlet",
          "defaultState": false,
          "delayOff": 0
        },
        {
          "name": "Heater",
          "type": "switch",
          "delayOff": 10000
        }
      ]
    },
    {
      "name": "Bedroom",
      "switchBehavior": "single",
      "switches": [
        {
          "name": "Scene 1",
          "type": "switch"
        },
        {
          "name": "Scene 2",
          "type": "switch"
        }
      ]
    }
  ]
}

Platform Options

| Field | Type | Required | Description | |-----------|--------|----------|-------------------------------| | name | string | Yes | Name of the platform instance | | devices | array | Yes | List of devices to create |

Device Options

| Field | Type | Required | Description | |--------------------|---------|----------|-------------------------------------------------| | name | string | Yes | Device name (becomes HomeKit accessory name) | | switchBehavior | string | No | independent or single (default: independent) | | masterSwitch | boolean | No | Enable master switch (Independent mode only) | | masterSwitchType | string | No | switch or outlet (default: switch) | | switches | array | Yes | List of switches for this device |

Per-Switch Options

| Field | Type | Required | Description | |----------------|---------|----------|---------------------------------------------------| | name | string | Yes | Name of the switch | | type | string | No | switch or outlet (default: outlet) | | defaultState | boolean | No | Initial power state (default: false) | | delayOff | number | No | Auto turn off after N milliseconds (default: 0) |

Example Use Cases

• Simulate smart plugs for automation testing
• Trigger HomeKit scenes manually
• Create virtual switches for non-HomeKit devices
• Group several virtual accessories under one device

Links

• NPM Package
• Homebridge
• Plugin Issues

License

MIT © Azad Aydınlı