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 master switch controls the rest
• Single Mode – Only one switch can be active at a time
• Per-switch config support (type, auto-off, default state)
• Switch states are preserved after Homebridge restart
• Fully dynamic config reload (no need to restart Homebridge)
• 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 (Platform Mode)

Configure from Homebridge UI or manually edit config.json like below:

{
  "platform": "MultipleSwitchPlatform",
  "name": "Multiple Switches",
  "switches": [
    {
      "name": "Heater",
      "type": "outlet",
      "defaultState": true,
      "autoTurnOff": 10000
    },
    {
      "name": "Fan",
      "type": "fan"
    },
    {
      "name": "Light",
      "type": "lightbulb",
      "autoTurnOff": 5000
    }
  ],
  "mode": "single"
}

🔧 Configuration Options

Each object inside switches[] can include:

• name: Name of the switch
• type: Optional (switch, outlet, etc.)
• autoTurnOff: Optional (in ms)
• defaultState: Optional (true/false)

📣 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ı