Skip to content

HomeAssistant Custom Integration for Leslies Pool water test results

License

Notifications You must be signed in to change notification settings

connorgallopo/leslies-pool

Repository files navigation

Leslies Pool Water Test Results

GitHub Release GitHub Activity License

pre-commit Black

hacs Project Maintenance BuyMeCoffee

Discord Community Forum

This integration leverages Leslie's Pools chemical results internal API to get those results and expose them to HomeAssistant. This will fetch data for both Leslies in-store tests as well as the test results from the AccuBlue home tester.

This component will set up the following platforms.

Platform Description
sensor Show info from leslies_pool API.

The component will set up the following sensors:

  • Free Chlorine - PPM
  • Total Chlorine - PPM
  • PH - pH
  • Alkalinity - PPM
  • Calcium - PPM
  • Cyanuric Acid - PPM
  • Iron - PPM
  • Copper - PPM
  • Phosphates - PPB
  • Salt - PPM

Installation - Automatic (REQUIRES HACS)

  1. Add this repository URL to HACS custom repositories as an Integration
  2. Search for "Leslies" and install the integration
  3. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "leslies_pool"
  4. Follow config flow

Installation - Manaul

  1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory (folder) there, you need to create it.
  3. In the custom_components directory (folder) create a new folder called leslies_pool.
  4. Download all the files from the custom_components/leslies_pool/ directory (folder) in this repository.
  5. Place the files you downloaded in the new directory (folder) you created.
  6. Restart Home Assistant
  7. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "leslies_pool"

Setup

  1. Provide the Username and Password for your leslie's account. These are used to auth and refresh cookies
  2. Input the Water Test URL. This can be found by navigating here once logged in, and then by clicking on "Water Tests" for the pool you want to integrate. The water test URL can be copied from the URL bar once you have navigated there. This URL contains the Pool ID and Pool Name which are needed to make the API calls to fetch the data.
  3. Set a polling rate (Seconds).

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines

Credits

This project was generated from @oncleben31's Home Assistant Custom Component Cookiecutter template.

Code template was mainly taken from @Ludeeus's integration_blueprint template