Getting Started¶
Prerequisites¶
Pool Manager aggregates readings from existing Home Assistant sensor entities. You need at least the following sensors already configured in your Home Assistant instance:
Required sensors¶
| Sensor | Unit | Description |
|---|---|---|
| Water temperature | °C | Pool water temperature |
| pH | -- | pH level (0--14 scale) |
| ORP | mV | Oxidation-Reduction Potential |
Optional sensors¶
These sensors enable additional recommendations and improve the water quality score accuracy:
| Sensor | Unit | Description |
|---|---|---|
| Free Chlorine | ppm | Free chlorine level (supplements ORP) |
| EC (Electrical Conductivity) | µS/cm | Conductivity level (diagnostic/trending) |
| Salt | ppm | Salt level (for salt electrolysis pools) |
| TAC (Total Alkalinity) | ppm | Alkalinity level |
| CYA (Cyanuric Acid) | ppm | Stabilizer level |
| Calcium Hardness | ppm | Water hardness |
| Outdoor temperature | °C | Ambient / air temperature (improves filtration recommendation) |
Optional actuators¶
| Entity | Type | Description |
|---|---|---|
| Pump switch | switch | Pump on/off entity. Enables filtration control (automatic daily pump scheduling). |
Compatible sensor sources¶
Your sensors can come from any source:
- Dedicated pool probes: Flipr, iopool, Sutro, Blue Connect, etc.
- DIY sensors: ESPHome, Tasmota, or any MQTT-based sensor
- Manual input: Home Assistant input_number helpers for manual readings
Installation¶
HACS (recommended)¶
Or manually add as a custom repository:
- Open HACS in Home Assistant
- Go to Integrations
- Click the three-dot menu and select Custom repositories
- Add
noirbizarre/hass-poolmanwith category Integration - Search for and install Pool Manager
- Restart Home Assistant
Manual installation¶
- Download the latest release
- Copy the
custom_components/poolmandirectory into your Home Assistantconfig/custom_components/directory - Restart Home Assistant
Configuration¶
Or go to Settings > Devices & Services > Add Integration and search for Pool Manager.
The integration is configured through a four-step UI flow. No YAML configuration is needed.
Step 1: Pool basics¶
The first step collects your pool's physical characteristics.
Required parameters¶
| Parameter | Type | Default | Description |
|---|---|---|---|
| Pool name | text | My Pool | Name for your pool (used as device name and unique identifier) |
| Volume | number (m³) | 50.0 | Pool water volume (1--500 m³) |
| Shape | select | Rectangular | Pool shape: Rectangular, Round, or Freeform |
Step 2: Chemistry¶
The second step configures your water treatment method and chemistry sensor entities.
Required parameters¶
| Parameter | Type | Default | Description |
|---|---|---|---|
| Treatment type | select | Chlorine | Water treatment method: Chlorine, Salt electrolysis, Bromine, or Active oxygen |
| pH entity | entity (sensor) | -- | pH sensor entity |
| ORP entity | entity (sensor) | -- | ORP sensor entity |
The treatment type determines which sanitizer products are recommended by the rule engine. For example, a chlorine-treated pool will receive chlorine tablet recommendations, while a bromine-treated pool will receive bromine tablet recommendations.
Optional parameters¶
| Parameter | Type | Description |
|---|---|---|
| Free chlorine entity | entity (sensor) | Free chlorine sensor (supplements ORP for sanitizer evaluation) |
| EC entity | entity (sensor) | Electrical conductivity sensor (diagnostic, no scoring) |
| Salt entity | entity (sensor) | Salt level sensor (for salt electrolysis pools) |
| TAC entity | entity (sensor) | Total Alkalinity sensor |
| CYA entity | entity (sensor) | Cyanuric Acid / Stabilizer sensor |
| Hardness entity | entity (sensor) | Calcium Hardness sensor |
| TDS conversion factor | number | Factor to convert EC to TDS (default 0.5, range 0.4--0.8) |
Step 3: Measuring spoons¶
The third step lets you configure up to three named measuring spoon sizes. When spoon sizes are defined, dosage recommendations will include an approximate number of spoons alongside the gram-based quantity (see Spoon Equivalents).
This step is entirely optional -- you can skip it by submitting the form without filling in any spoon names.
Optional parameters (up to 3 pairs)¶
| Parameter | Type | Description |
|---|---|---|
| Spoon name | text | Label for the spoon (e.g. "Small", "Large", "Tablespoon") |
| Spoon size | number (mL) | Volume of the spoon in milliliters |
Only pairs where both the name is non-empty and the size is greater than zero are saved.
Common spoon sizes
| Spoon | Approximate volume |
|---|---|
| Teaspoon | 5 mL |
| Dessertspoon | 10 mL |
| Tablespoon | 15 mL |
| Pool scoop (small) | 25 mL |
| Pool scoop (large) | 50 mL |
Step 4: Filtration¶
The fourth step configures your filtration system.
Required parameters¶
| Parameter | Type | Default | Description |
|---|---|---|---|
| Filtration type | select | Sand | Filter type: Sand, Cartridge, Diatomaceous Earth, or Glass |
| Pump flow rate | number (m³/h) | 10.0 | Pump flow rate (1--50 m³/h) |
| Temperature entity | entity (sensor) | -- | Water temperature sensor entity |
Optional parameters¶
| Parameter | Type | Description |
|---|---|---|
| Pump entity | entity (switch) | Pump switch for filtration control (automatic daily scheduling) |
| Outdoor temperature entity | entity (sensor) | Outdoor / air temperature sensor for heat stress adjustment |
| Weather entity | entity (weather) | Weather integration entity (used as fallback for outdoor temperature) |
Outdoor temperature sources
You can configure an outdoor temperature sensor, a weather entity, or both.
When both are provided, the dedicated sensor takes priority. The weather
entity's temperature attribute is used as a fallback.
See Pool Modes
for how outdoor temperature affects filtration duration.
Multiple pools
You can add the integration multiple times to manage several pools. Each pool is identified by its name, which must be unique.
Reconfiguring settings¶
After initial setup, you can modify your chemistry and filtration settings at any time through the integration's options:
- Go to Settings > Devices & Services
- Find Pool Manager and click Configure
- Update the treatment type, chemistry sensors, spoon sizes, filtration type, pump flow rate, temperature sensor, outdoor temperature sensor, weather entity, or pump entity
Changes take effect immediately -- the integration reloads automatically.
Update interval¶
Pool Manager reads your sensor entities and recomputes all analytics every 5 minutes. This interval is fixed and not configurable. Since all computation is local, this has negligible impact on system performance.