Your reef, in your smart home.

Install the integration

You need HACS in Home Assistant.

1. Open HACS and search for Reefability.
2. Not listed yet? Open the menu (three dots), then Custom repositories, add this address with the type Integration, and search again.https://github.com/Reefability/reefability-homeassistant
3. Download it and restart Home Assistant.

Connect your account

1. In the Reefability app open More, then Home Assistant, then Create a token, and copy it. It is shown only once.
2. In Home Assistant open Settings, Devices & services, Add integration, pick Reefability and paste the token.

Each tank appears as a device and refreshes every 5 minutes. You can remove the token in the app at any time.

Send sensors to Reefability optional

Open Settings, Devices & services, Reefability, Configure. Pick the tank, then the sensors to send: tank probes (temperature, salinity, pH, ORP, alkalinity and more), room temperature, humidity and CO2, and leak sensors. Units are converted for you, and a wet leak sensor sends you an urgent push.

Ideas to start with

Entity names follow your tank names, so change them to match yours.

alias: Leak, stop the return pump
triggers:
  - trigger: state
    entity_id: binary_sensor.display_tank_leak
    to: "on"
actions:
  - action: switch.turn_off
    target:
      entity_id: switch.return_pump

alias: Alkalinity outside my ideal range
triggers:
  - trigger: state
    entity_id: binary_sensor.display_tank_out_of_range
    to: "on"
actions:
  - action: notify.mobile_app_my_phone
    data:
      message: >
        {{ states('sensor.display_tank_alkalinity') }} dKH,
        ideal {{ state_attr('sensor.display_tank_alkalinity', 'ideal_low') }}
        to {{ state_attr('sensor.display_tank_alkalinity', 'ideal_high') }}

action: reefability.log_reading
data:
  device_id: <your tank>
  parameter: Alkalinity
  value: 8.2
  unit: dKH