Skip to content
This component reads and displays the boiler status values from a rooted TOON thermostat.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

hacs_badge made-with-python Donate

TOON Boiler Status Sensor Component

This is a Custom Component for Home-Assistant ( that reads and displays the boiler status values from a rooted TOON thermostat.

NOTE: This component only works with rooted TOON devices. TOON thermostats are available in The Netherlands and Belgium.

More information about rooting your TOON can be found here: Eneco TOON as Domotica controller

You also need to install ToonStore and the BoilerStatus app, you can find information on how to install these on forum mentioned above.


HACS - Recommended

  • Have HACS installed, this will allow you to easily manage and track updates.
  • Search for 'TOON Boiler Status'.
  • Click Install below the found integration.
  • Configure using the configuration instructions below.
  • Restart Home-Assistant.


  • Copy directory custom_components/toon_boilerstatus to your <config dir>/custom_components directory.
  • Configure with config below.
  • Restart Home-Assistant.


To use this component in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry

  - platform: toon_boilerstatus
    host: IP_ADDRESS
    port: 10080
    scan_interval: 10
      - boilersetpoint
      - boilerintemp
      - boilerouttemp
      - boilerpressure
      - boilermodulationlevel
      - roomtemp
      - roomtempsetpoint

Configuration variables:

  • host (Required): The IP address on which the TOON can be reached.
  • port (Optional): Port used by your TOON. (default = 10080)
  • scan_interval (Optional): Number of seconds between polls. (default = 10)
  • resources (Required): This section tells the component which values to display and monitor.

By default the values are displayed as badges.

If you want them grouped instead of having the separate sensor badges, you can use these entries in your groups.yaml:

# Example groups.yaml entry

Boiler Status:
  - sensor.toon_boiler_intemp
  - sensor.toon_boiler_outtemp
  - sensor.toon_boiler_setpoint
  - sensor.toon_boiler_pressure
  - sensor.toon_boiler_modulation
  - sensor.toon_room_temp
  - sensor.toon_room_temp_setpoint


alt text



You can’t perform that action at this time.