homebridge-flume

Homebridge plugin to integrate Flume devices into Apple HomeKit

Disclaimer

This plugin is independently developed and is not in any way affiliated with or endorsed by Flume. Any issues or damage resulting from use of this plugin are not the fault of the developer. Use at your own risk.

What does this plugin do?

Once you have completed Configuration you will see a new leak sensor pop up in your Home app. If the sensor detetcs a leak, you will receive a HomeKit notification and can setup automations to react to state changes.

If you use a more advanced HomeKit app like Eve or Controller for Homekit, you will see some additional information about your water use. Unfortunately, Apple currently doesn't offer a way to display this in the Home app.

Configuration

You'll need to get your API Access Client ID and Client Secret from the Flume portal.

This guide provides step-by-step instructions.

Using the Homebridge Config UI is the easiest way to set up this plugin. However, if you wish to do things manually then you will need to add the following to your Homebridge config.json:

{
  "name": "Flume",
  "platform": "Flume",
  "username": "[username]",
  "password": "[password]",
  "clientId": "1234567890ABCD",
  "clientSecret": "1234567890ABCDEFGHIJ",
  "refreshInterval": 1,
  "units": "GALLONS",
  "disableDeviceLogging": false,
  "verbose": false,
  "excludeDevices": ["1234567890", "9876543210"]
}

• username - (Required) Flume username
• password - (Required) Flume password
• clientId/clientSecret - (Required) Flume Client ID, found at https://portal.flumetech.com
• refreshInterval - (Required) number of minutes between updates; must be 1 or more
• useNotifications - (Optional) if true, an unread usage alert notification will be considered a leak
  • To clear leaks, mark notifications as read in the Flume app.
• units - (Required) the type of units to use for custom characteristics
• disableDeviceLogging - (Optional) if true, then accessory status changes will not be logged
• verbose - (Optional) if true, there will be additional logging for debugging purposes
• excludeDevices - (Optional) a list of devices to exclude; look for Adding new device: [Device ID] in the logs

Credits

@LexifOder for German translations

@dcompane for Spanish translations

Keryan Belahcene for creating the Flume header logo

@bwp91 for creating and maintaining this plugin for years despite not even owning a Flume device

@weallknowwhoisatfaulthere for earlier work done homebridge-flume-water-sensor

And to the amazing creators/contributors of Homebridge who made this plugin possible!