homebridge-http-multiswitch

homebridge-http-homebridge

Simple HTTP switches for Homebridge - stateful and radio-button/multi-switch switches

*Forked from homebridge-switcheroo

---

Creating and maintaining Homebridge plugins consume a lot of time and effort, if you would like to share your appreciation, feel free to "Star" or donate.

Click here to review more of my plugins.

---

Switch Services

Switch (standard on/off)

Meant to be used as a standard on/off switch. Light, projector, fan, etc.

{
        "accessory": "HttpMultiswitch",
        "switch_type": "Switch",
        "name": "My Projector",
        "http_method": "GET",
        "base_url": "http://192.168.0.XXX/command",
        "on_url": "/on",
        "off_url": "/off"
}

Multiswitch (radio buttons)

Meant to be used as a switcher, where only one input is ever on. Automaticaly turns off the other switches when turning on one ofe them.

Multiswitch appends the string, defined under 'multiurls' below, to complete the path of the Url (Must be use in the same order of the devices in "multiswitch". For example, when PC Mode is selected, the url generated will be http://192.168.0.XXX/command?id=42786sdf787.

{
    "accessory": "HttpMultiswitch",
    "switch_type": "Multiswitch",
    "name": "My Multiswitch",
    "http_method": "GET",
    "base_url": "http://192.168.0.XXX/command?id=",
    "multiswitch": [
                "Apple TV Mode",
                "PC Mode",
                "Android Mode",
                "The Music Mode"
            ],
    "multiurls": [
                "43",
                "42786sdf787",
                "l1479461871215",
                "44"
            ]
}

Configuration Params

Parameter	Description	Required
name	name of the accessory
switch_type	Switch or Multiswitch	✓
base_url	url endpoint for whatever is receiving these requests	✓
http_method	GET (default), POST, PUT, DELETE
username	username for request
password	password for request
send_immediately	option for request
referer	option for request
on_url (only Switch)	endpoint for the on state	✓
off_url (only Switch)	endpoint for the off state	✓
on_body (only Switch)	body for on state request
off_body (only Switch)	body for off state request
multiswitch (only Multiswitch)	list of inputs for the Multiswitch - order is respected	✓
multiurls (only Multiswitch)	list of endpoint urls for multiswitch-order is respected	✓

Help

• Make sure specify a port in the if necessary. (i.e. "base_url" : "http://192.168.0.XXX:2000")
• Verify the correct http_method is begin used. Switcheroo defaults to GET

Installation

Read about an example Raspberry Pi + Homebridge setup guide with this package here.

1. Install homebridge using: npm install -g homebridge
2. Install homebridge-http using: npm install -g homebridge-http-multiswitch
3. Update your config file