homebridge-multiple-switch

homebridge-multiple-switch

A lightweight Homebridge plugin that lets you create multiple customizable dummy switches under a single accessory — configurable as Switch, Outlet, Lightbulb, or Fan. Supports Independent, Master, and Single switch modes.

Features

• Grouped multiple switches in one HomeKit tile
• Accessory type: switch, outlet, lightbulb, or fan
• Independent Mode – All switches operate separately
• Master Mode – One switch controls all others
• Single Mode – Only one switch can be active at a time
• Per-switch config support (type, auto-off delay, default state)
• Switch states preserved across Homebridge restarts via cached accessories
• Automatic cleanup of stale accessories on config change
• Compatible with HomeKit and Siri

Installation

Install via Homebridge UI:

• Open Plugins
• Search for homebridge-multiple-switch
• 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 Switches",
  "switchBehavior": "single",
  "switches": [
    {
      "name": "Heater",
      "type": "outlet",
      "defaultState": true,
      "delayOff": 10000
    },
    {
      "name": "Fan",
      "type": "fan"
    },
    {
      "name": "Light",
      "type": "lightbulb",
      "delayOff": 5000
    }
  ]
}

Platform Options

Field	Type	Required	Description
name	string	Yes	Name of the platform instance
switchBehavior	string	No	independent, master, or single
switches	array	Yes	List of switches to create

Per-Switch Options

Field	Type	Required	Description
name	string	Yes	Name of the switch
type	string	No	switch, outlet, lightbulb, or fan
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
• Combine several virtual accessories under one tile

Links

• NPM Package
• Homebridge
• Plugin Issues

License

MIT © Azad Aydınlı