https://github.com/dala318/python_poollab

Python API for Pool Lab
https://github.com/dala318/python_poollab

chlorine cloud-api gql hacs-integration home-assistant ph-monitoring pool poollab python

Last synced: 9 months ago
JSON representation

Python API for Pool Lab

• Host: GitHub
• URL: https://github.com/dala318/python_poollab
• Owner: dala318
• License: mit
• Created: 2022-06-11T10:55:20.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-04-26T12:54:09.000Z (10 months ago)
• Last Synced: 2025-05-12T23:44:15.342Z (9 months ago)
• Topics: chlorine, cloud-api, gql, hacs-integration, home-assistant, ph-monitoring, pool, poollab, python
• Language: Python
• Homepage:
• Size: 202 KB
• Stars: 12
• Watchers: 2
• Forks: 4
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
[![Validate with hassfest](https://github.com/dala318/python_poollab/actions/workflows/hassfest.yaml/badge.svg)](https://github.com/dala318/python_poollab/actions/workflows/hassfest.yaml)

[![HACS Action](https://github.com/dala318/python_poollab/actions/workflows/hacs.yaml/badge.svg)](https://github.com/dala318/python_poollab/actions/workflows/hacs.yaml)

[![Release](https://github.com/dala318/python_poollab/actions/workflows/release.yaml/badge.svg)](https://github.com/dala318/python_poollab/actions/workflows/release.yaml)

[![Dependabot Updates](https://github.com/dala318/python_poollab/actions/workflows/dependabot/dependabot-updates/badge.svg)](https://github.com/dala318/python_poollab/actions/workflows/dependabot/dependabot-updates)

![Logo](PoolLab.jpg)

# Python PoolLab (Home Assistant)

Python API for Pool Lab 1.0

For now only fetching all data and parsing to classes.

## Stand-alone usage

You only need the file [poollab.py](custom_components/poollab/poollab.py)

```python

from poollab import PoolLabApi

poollab_api = PoolLabApi("API_TOKEN_FROM_https://labcom.cloud/pages/user-setting")

print(asyncio.run(poollab_api.request()))

```

## Home Assistant integration

### Install

1. Go to HACS -> Integrations

2. Click the three dots on the top right and select `Custom Repositories`

3. Enter `https://github.com/dala318/python_poollab` as repository, select the category `Integration` and click Add

4. A new custom integration shows up for installation (PoolLab) - install it

5. Restart Home Assistant

### Configuration

1. Get a API token to your cloud data from https://labcom.cloud/pages/user-setting

2. Klick Add integration and select "poollab"

3. In the configuration window enter the API token

4. Each pool in your account should be shown as an own device which you can add to a room

![Example device](device_integration_example.png)

### Entity attributes

Each sensor entity has the value of the last measurement of each parameter, based on the timestamp from device (not the one stored last)

In addition some attributes are provided

* `Measured at`: The device timestamp at measure

* `Measure`: The unique id of the measure

* `Ideal low`: Lower limit for ok

* `Ideal high`: Upper limit for ok

* `Device serial`: Device serial of the device that made the measure

* `Operator name`: Mane of operator that did the measurement

* `Comment`: Comment to measurement