Skip to content

homebridge-device-alive is a plugin for Homebridge which allows you to check if a device is online in your network. It support both IP addresses and Mac addresses. It uses a Homebridge Motion Sensor accessory to indicate if a device is available on the local network.

License

marcveens/homebridge-device-alive

Repository files navigation

homebridge-device-alive

verified-by-homebridge homebridge-device-alive mit-license

homebridge-device-alive is a plugin for homebridge which allows you to check if a device is online in your network. It supports both IP addresses and MAC addresses, but only either of them is used per device configuration. It uses a Homebridge Motion Sensor accessory to indicate if a device is available on the local network.

Installation

If you are new to homebridge, please first read the homebridge documentation. If you are running on a Raspberry, you will find a tutorial in the homebridge wiki.

Install homebridge:

sudo npm install -g homebridge

Install homebridge-device-alive:

sudo npm install -g homebridge-device-alive

Configuration

Add the DeviceAlive platform in config.json in your home directory inside .homebridge.

Example configuration:

{
  "platforms": [
    {
        "platform": "DeviceAlive",
        "checkInterval": 5000,
        "devices": [
            {
                "name": "Soundbar",
                "mac": "ff:ff:ff:ff:ff:ff"
            },
            {
                "name": "Phone",
                "ip": "192.168.172.10"
            }
        ],
    }
  ]
}

Every device stated in the config will be automatically added as an accessory to HomeKit.

Platform Configuration fields

Property Required? Remarks
platform ✔️ Should always be "DeviceAlive".
changeChecks ✔️ A list of your devices.

Device Configuration fields

Either MAC or IP address is required.

Property Required? Remarks
name ✔️ Name of the device you want to add
mac Mac address of the device you want to check on your local network. Should be in lowercase.
ip IP address of the device you want to check on your local network

Backstory

This plugin is actually developed for use in Apple Shortcuts. I had a problem where I wanted to use a IR blaster to turn on and off some devices, but only had 1 signal for both statuses. I could not check if the device was already turned off when I ran a shortcut, thus the device would turn on again. This plugin can make sure no signal is sent if the device is already turned off.

About

homebridge-device-alive is a plugin for Homebridge which allows you to check if a device is online in your network. It support both IP addresses and Mac addresses. It uses a Homebridge Motion Sensor accessory to indicate if a device is available on the local network.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published