{"id":43271244,"url":"https://github.com/maeek/ha-aux-cloud","last_synced_at":"2026-04-03T21:11:45.820Z","repository":{"id":229368207,"uuid":"772764009","full_name":"maeek/ha-aux-cloud","owner":"maeek","description":"Home assistant integration for Aux Cloud connected appliances (AC Freedom)","archived":false,"fork":false,"pushed_at":"2026-01-29T22:09:30.000Z","size":150,"stargazers_count":65,"open_issues_count":11,"forks_count":9,"subscribers_count":11,"default_branch":"main","last_synced_at":"2026-01-30T11:45:02.071Z","etag":null,"topics":["aux","broadlink","hacs","hacs-integration","home-assistant"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maeek.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-03-15T21:10:17.000Z","updated_at":"2026-01-29T22:06:53.000Z","dependencies_parsed_at":"2024-03-23T21:28:10.587Z","dependency_job_id":"2c190626-dc90-4100-adb2-d4342b38bad5","html_url":"https://github.com/maeek/ha-aux-cloud","commit_stats":null,"previous_names":["maeek/ha-aux-cloud"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/maeek/ha-aux-cloud","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maeek%2Fha-aux-cloud","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maeek%2Fha-aux-cloud/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maeek%2Fha-aux-cloud/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maeek%2Fha-aux-cloud/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maeek","download_url":"https://codeload.github.com/maeek/ha-aux-cloud/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maeek%2Fha-aux-cloud/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28981893,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T15:35:50.179Z","status":"ssl_error","status_checked_at":"2026-02-01T15:35:38.075Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["aux","broadlink","hacs","hacs-integration","home-assistant"],"created_at":"2026-02-01T16:02:21.038Z","updated_at":"2026-02-01T16:02:21.938Z","avatar_url":"https://github.com/maeek.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AUX Cloud Integration for Home Assistant\n\nUnofficial integration for Aux Cloud connected appliances like air conditioners and heat pumps. Aux Cloud is a service\nbased on the Broadlink platform that allows you to control your appliances from anywhere. This is a cloud alternative\nto [replacing wifi module in your AC](https://github.com/GrKoR/esphome_aux_ac_component). This integration will also allow you\nto control AUX heat pumps. The implementation of API requests is based on public resources from [Broadlink documentation](https://docs.ibroadlink.com/public/appsdk/sdk_others/dnacontrol/) and reverse engineering.\n\n## Features\n\n- Control AUX air conditioners and heat pumps from Home Assistant\n- View device status and sensor readings\n- Support for both personal and shared devices\n- Secure credential storage (when configured through UI)\n\n## Installation\n\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=maeek\u0026repository=ha-aux-cloud\u0026category=integration)\n[![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=aux_cloud)\n\n## HACS Installation (Recommended)\n\n1. Make sure you have [HACS](https://hacs.xyz/) installed\n2. Go to HACS \u003e Integrations\n3. Search for \"AUX Cloud\"\n4. Install the integration\n5. Restart Home Assistant\n\n## Manual Installation\n\n1. Download this repository\n2. Copy the `custom_components/aux_cloud` folder to your Home Assistant `custom_components` directory\n3. Restart Home Assistant\n\n## Configuration\n\n## UI Configuration (Recommended)\n\nThe recommended way to set up this integration is through the Home Assistant UI:\n\n1. Go to **Settings** \u003e **Devices \u0026 Services**\n2. Click the **+ Add Integration** button\n3. Search for \"AUX Cloud\" and select it\n4. Enter your AUX Cloud email and password\n5. Select your region (e.g., Europe, USA or China - based on your AUX Cloud account)\n6. Select which devices you want to add to Home Assistant\n\n  \u003e [!TIP]\n  \u003e Make sure that your devices are online when setting up the integration. If you add a device that is offline, it will not add all the entities. You will need to reload the integration manually.\n\nYour credentials will be stored securely in Home Assistant's `.storage/core.config_entries` storage.\n\n## Usage\n\nAfter setting up the integration, your AUX devices will be available as climate entities in Home Assistant. You can\ncontrol them through:\n\n- The Home Assistant UI\n- Automations\n- Scripts\n- Voice assistants integrated with Home Assistant\n\n## Troubleshooting\n\nIf you encounter issues:\n\n1. Check the Home Assistant logs for error messages\n2. Verify your AUX Cloud credentials and selected region is correct\n3. Ensure your devices are online and accessible through the AUX Cloud app\n4. If you've recently changed your password, you'll need to reconfigure the integration\n\n## Known Issues\n\n- **Logging in the App**: The login process in the app will log out any existing sessions (at least on Android). If you log in the app, reload the integration.\n\n\u003e [!NOTE]\n\u003e There are plans to implement automatic relogging if the request fails due to session expiry.\n\n- **Shared devices**: If your account has shared devices, you might encounter an issue that `Platform aux_cloud does not generate unique ids`, check your HA logs and transfer ownership of the device to your account.\n\n## Development\n\nThis integration is still in development. Current status:\n\n- [x] Reverse engineer the AUX Cloud API\n- [x] [API] Implement login\n- [x] [API] Implement getting devices' information\n- [x] [Home Assistant] Config flow with device selection\n- [x] [API] Implement updating device state\n- [x] [Home Assistant] Cloud data fetcher\n- [x] [Home Assistant] Data coordinator\n- [x] [Home Assistant] climate entity\n- [x] [Home Assistant] sensor entity\n- [x] [Home Assistant] water heater entity\n- [x] [Home Assistant] basic sensor entities\n- [x] [Home Assistant] switch entity\n- [x] [Home Assistant] Fix reconfigure - adding new devices requires reload of integration\n- [x] [Home Assistant] Parallelize data fetching for devices - don't wait for one device to finish before starting another\n- [x] [Home Assistant] Add an icon to https://github.com/home-assistant/brands\n- [ ] [API] Implement session check and re-login\n- [ ] [Home Assistant] services\n- [ ] [Home Assistant] Manual tests\n- [ ] [Home Assistant] Unit tests\n- [ ] [API] WebSocket connection for instant updates\n- [x] Documentation\n- [ ] Add to HACS\n- [ ] Translations\n\n## Privacy\n\nThis integration communicates with the AUX Cloud servers but stores your credentials locally in Home Assistant's internal storage (when configured through the UI). No data is shared with third parties beyond what's necessary to communicate with AUX Cloud services.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## Testing\n\nThis document describes how to run tests and perform code quality checks for the AUX Cloud Integration.\n\n## Devices\n\nIntegration support and was tested on devices:\n- AC:\n  1. AUX Freedom model AUX-12F2H/I\n- Heat pump:\n  1. AUX ACHP-HO8/4R3HA-I\n\n## Prerequisites\n\nBefore running tests, ensure you have all the required dependencies installed:\n\n```bash\npip install -r requirements.test.txt\n```\n\n## Running Tests with pytest\n\n### Basic Test Run\n\nRun all tests:\n\n```bash\npytest\n```\n\n### Test with Coverage Reporting\n\nRun tests and show coverage information:\n\n```bash\npytest --cov=custom_components\n```\n\n## Code Quality Checks with pylint\n\n### Basic pylint Check\n\nRun pylint on the entire component:\n\n```bash\npylint custom_components/aux_cloud\n```\n\n### Code formatting\n\nThe project uses [Black](https://pypi.org/project/black/) for code formatting. To format the code, run:\n\n```bash\nblack custom_components/aux_cloud\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaeek%2Fha-aux-cloud","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaeek%2Fha-aux-cloud","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaeek%2Fha-aux-cloud/lists"}