Not production ready! Flume water sensor (using the leak and light sensor services) for Homebridge. As of Aug 5, 2020 this is actively in development so it's super buggy! I welcome your help debugging.

Usage no npm install needed!

<script type="module">
  import homebridgeFlumeWaterSensor from 'https://cdn.skypack.dev/homebridge-flume-water-sensor';




  1. Install homebridge using: npm install -g homebridge
  2. Install dependencies using:
    • npm install node-fetch
    • npm install jwt-decode
  3. Install this plugin using: npm install -g homebridge-flume-water-sensor
  4. Update your configuration file. See sample config.json snippet below.


Configuration sample:

   "accessories": [
           "accessory": "Flume",
           "name": "Flume Water Monitor",
           "username": "drthomas@darrinthomas.com",
           "password": "dudeabides",            
           "client_id": "12345678901234567890",
           "client_secret": "1234567890",
           "polling_minutes": 1,
           "handicap": 0.1,


  • "accessory": Must always be "Flume" (required)
  • "username": Your username for acessing the Flume site at https://portal.flumetech.com/ (required)
  • "password": Your password for acessing the Flume site (required)
  • "client_id": Your Client ID for API access, found in Settings on the Flume site (required)
  • "client_secret": Your Client Secret for API access, found in Settings on the Flume site (required)
  • "polling_minutes": Number of minutes between updates. Defaults to 1 minute. API has a cap of 120 calls per hour. (optional)
  • "handicap": Set to ignore a steady water draw below this value. Defaults to zero (0.0) gallons. (optional)

Retrieving API Login Credentials

You'll need to get your API Access Client ID and Client Secret from Flume's site at https://portal.flumetech.com/ This guide offers the steps to take: https://flumetech.readme.io/reference#accessing-the-api