Skip to content

felippepuhle/tholz-hass-integration

Repository files navigation

GitHub Release License hacs

Tholz Home Assistant Integration

This custom integration provides control and monitoring for Tholz Smart devices. The following models have been tested:

  • Tholz Smart Pool v2
  • Tholz Smart Heat v2

Features

  • Sensors & Binary Sensors (e.g., header and temperature sensors)
  • Water Heater Control (heating entities)
  • Pump Controls (switch entities)

⚠️ Some entities are still under development and will be added in future updates.

Installation

The recommended installation method is via HACS:

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Notes:

  • HACS only installs the files; you still need to go to Settings → Devices & Services and add the integration manually.
  • For manual installation (advanced users), copy custom_components/tholz to your Home Assistant custom_components directory.

Configuration

After restarting, add the integration via the Home Assistant UI:

  1. Go to Settings → Devices & Services → Add Integration → Tholz.

    step1
  2. Provide the required information:

    step2
    • Name: Friendly name for your device
    • IP Address: Device IP address
    • Port: Socket connection port
    • Polling Interval: How often (in seconds) device data is refreshed

Example configuration in action

Controls:
controls

Sensors:
sensors