homebridge-mpower

Homebridge plugin that provides on/off switching for Ubiquiti mPower outlets

Usage no npm install needed!

<script type="module">
  import homebridgeMpower from 'https://cdn.skypack.dev/homebridge-mpower';
</script>

README

homebridge-mpower

This is a plugin for homebridge. It allows you to control your Ubiquiti mPower outlets with HomeKit.

Installation

  1. Install homebridge (if not already installed) using: npm install -g homebridge
  2. Install this plugin using: npm install -g homebridge-mpower
  3. Update your configuration file. See below for a sample.

Configuration

"platforms": [
  {
    "platform": "mPower",
    "name": "mPower",
    "outlets": [
      {
        "name": "Fan",
        "username": "admin",
        "password": "hunter2",
        "url": "10.0.1.5",
        "id": "1"
      },
      {
        "name": "Hall Light",
        "username": "admin",
        "password": "hunter2",
        "url": "10.0.1.5",
        "id": "2"
      },
      {
        "name": "Mr. Coffee",
        "username": "admin",
        "password": "Correct Horse Battery Staple",
        "url": "10.0.1.6",
        "id": "1"
      }
    ]
  }
]
Parameter Description
name The human-readable name of the device plugged into your outlet
username Your mFi Controller username
password Your mFi Controller password
url May be either a hostname or an IP address
id The specific outlet you hope to control. For mPower mini, this can only be 1. For mPower and mPower PRO, you might have to do some trial and error to figure out which outlet has which id. I only have an mPower mini, so I can't check :)

How it works

This plugin is basically a homebridge-compatible implementation of the Ubiquiti mFi outlet HTTP API. It sends a HTTP request via curl to your mFi outlet device (not the controller) to manually toggle the device on or off.

Acknowledgements

Major thanks to the other contributors who have improved this plugin: pponce