{"id":26641340,"url":"https://github.com/djtimca/haomnilogic","last_synced_at":"2025-04-10T20:54:33.866Z","repository":{"id":37620292,"uuid":"498391907","full_name":"djtimca/haomnilogic","owner":"djtimca","description":"Hayward Omnilogic integration for Home Assistant available through HACS","archived":false,"fork":false,"pushed_at":"2024-05-02T16:18:20.000Z","size":94,"stargazers_count":17,"open_issues_count":19,"forks_count":6,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-24T18:37:46.951Z","etag":null,"topics":["hacs-integration","hayward","homeassistant","homeassistant-custom-component","homeassistant-integration","omnilogic"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/djtimca.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-31T15:25:29.000Z","updated_at":"2024-08-17T20:11:50.000Z","dependencies_parsed_at":"2024-02-08T14:47:53.649Z","dependency_job_id":"b0b39d0a-c96b-42b0-8728-86881b794aa4","html_url":"https://github.com/djtimca/haomnilogic","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djtimca%2Fhaomnilogic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djtimca%2Fhaomnilogic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djtimca%2Fhaomnilogic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djtimca%2Fhaomnilogic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/djtimca","download_url":"https://codeload.github.com/djtimca/haomnilogic/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248297861,"owners_count":21080312,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacs-integration","hayward","homeassistant","homeassistant-custom-component","homeassistant-integration","omnilogic"],"created_at":"2025-03-24T18:28:18.858Z","updated_at":"2025-04-10T20:54:33.844Z","avatar_url":"https://github.com/djtimca.png","language":"Python","funding_links":["https://www.buymeacoffee.com/djtimca"],"categories":[],"sub_categories":[],"readme":"# Hayward Omnilogic Pool Controller\n\n\u003ca target=\"_blank\" href=\"https://www.buymeacoffee.com/djtimca\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" alt=\"Buy me a coffee\" style=\"height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;\"\u003e\u003c/a\u003e [![hacs_badge](https://img.shields.io/badge/HACS-Custom-41BDF5.svg?style=for-the-badge)](https://github.com/hacs/integration)\n\nThis integration will provide sensors and control for Hayward Omnilogic based pool\ncontrollers.\n\nSensors include:\n- Water and Air Temperature Sensors\n- Pump Speed Sensors\n- Salt Level Sensors\n- Chlorinator Sensors\n- PH and ORP Sensors\n- Pool Alarm Sensors\n\nControls include:\n- Colorlogic light controls\n- Pump on/off and speed controls\n- Relay on/off controls\n- Water Heater controls\n\n## Install\n\nOnce installed, go to `Configuration -\u003e Integrations` and click the + to add a new integration. On new instances of Home Assistant, `Settings -\u003e Devices \u0026 Services -\u003e Integrations` and click the **\"+ ADD INTEGRATION\"** in the bottom right to add the **Omnilogic** integration.\n\nSearch for **Omnilogic** and you will see the integration available.\n\nClick add, confirm you want to install, and enter your username (not email) and password\nfor your Hayward Omnilogic App login and everything should be added and available. A restart will be necessary in the process.\n\n### Repository Missing from HACS Integration Search\nIf the Omnilogic integration isn't found, you may have to add the repository to HACS using the following steps\n1. Open the HACS page/tab in Home Assistant\n2. Navigate to the **\"Integrations\"** tab\n3. Click on the three dots in the top right hand and select **\"Custom repositories\"** from the list of options\n4. Copy and paste this repoistories link `https://github.com/djtimca/haomnilogic` and paste it into the **\"Repository\"** input field\n5. Select **\"Integration\"** from the **\"Category\"** dropdown\n6. Click **\"Add\"**\n- Allow a few seconds for HACS to pull the latest information and data down. Once available, you'll be able to follow the install instructions above\n\nEnjoy!\n\n## Integration Usage\n\n[Hayward OmniLogic](https://www.hayward-pool.com/shop/en/pools/omnilogic-i-auomni--1) smart pool and spa technology control.\n\nThere is currently support for the following device types within Home Assistant:\n\n- ***Sensor*** - Air Temperature, Water Temperature, Variable Pump Speed, Chlorinator Setting, Instant and Average Salt Levels, pH, and ORP. Note that the Omnilogic controller allows temperature sensors to be renamed; sensors must be left at the default naming convention for the integration to properly recognize them (airTemp, waterTemp, etc.)\n- ***Switch*** - All relays, pumps (single, dual, variable speed), and relay-based lights.\n- ***Light*** - Colorlogic Lights (V1 and V2).\n- ***Water Heater*** - Pool heaters of different types.\n\n## Tips for Usage\n\nReview the [Wiki](https://github.com/djtimca/haomnilogic/wiki) for tips on how I have used custom cards and a few helpers/tricks to get the most out of this integration for my pool!\n\n## Sensor Platform Options\n\nIf you have pH sensors in your Omnilogic setup, you can add an offset to correct reporting from the sensor in the integration configuration.\n\nGo to the Integrations page in setup and choose 'Configure' to adjust your offsets.\n\n## Switch Platform\n\nThe switch platform contains a custom service to allow you to set the speed on variable speed pumps.\n\nTo set pump speed, call the `omnilogic.set_pump_speed` service as following:\n\n```yaml\nservice: omnilogic.set_pump_speed\ndata:\n  entity_id: Entity ID of the Pump\n  speed: Speed (0-100%)\n```\n\nNote the custom service is only available for variable speed pumps.\n\n## Light Platform\n\nThe light platform allows you to set the color or effect of your lights from the effect list supported by your light version.\n\nIf you have V2 Colorlogic lights you can also set the brightness and speed of the lights using the custom service `omnilogic.set_v2_lights` as following:\n\n```yaml\nservice: omnilogic.set_v2_lights\ndata:\n  entity_id: Entity ID of the Lights\n  speed: Speed (0-8) for the light effect (optional)\n  brightness: Brightness (0-4) for the lights (optional)\n```\n\n## Debugging integration\n\nIf you have problems with the integration, the first thing we will need to troubleshoot is the telemetry for your pool setup. Please:\n\n1. Go to: https://replit.com/@djtimca/OmniTesting\n2. Hit the 'Run' button at the top.\n3. Enter your username and password\n4. Hit Enter to clear your credentials\n5. After the script finishes, your file names will be listed in the output (eg. `output_116_5216g89yd5_telemetry.json`, `output_116_2859af29q03_msconfig.xml`, `output_116_c8528gw23y_telemetry.xml`)\n    - Click on the **\"Show Files\"** on the top left\n    - Look for the respective file and click on it to open and view the content\n        - It may be useful to `CTRL+F` for your file name as the sidebar view cannot be expanded\n    - Copy the telemetry data from the files.\n7. Post your telemetry when you open an issue in this repository as a json/XML code block so we can review and troubleshoot\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjtimca%2Fhaomnilogic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdjtimca%2Fhaomnilogic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjtimca%2Fhaomnilogic/lists"}