{"id":42623666,"url":"https://github.com/iprak/winix","last_synced_at":"2026-05-03T00:04:42.027Z","repository":{"id":43203066,"uuid":"316527506","full_name":"iprak/winix","owner":"iprak","description":"Home Assistant component for C545 Winix Air Purifier","archived":false,"fork":false,"pushed_at":"2026-01-18T02:18:39.000Z","size":312,"stargazers_count":159,"open_issues_count":3,"forks_count":29,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-01-18T14:33:30.769Z","etag":null,"topics":["home-assistant","homeassistant","purifier","winix"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iprak.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-11-27T14:46:19.000Z","updated_at":"2026-01-18T02:18:42.000Z","dependencies_parsed_at":"2026-01-05T19:02:23.754Z","dependency_job_id":null,"html_url":"https://github.com/iprak/winix","commit_stats":null,"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"purl":"pkg:github/iprak/winix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iprak%2Fwinix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iprak%2Fwinix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iprak%2Fwinix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iprak%2Fwinix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iprak","download_url":"https://codeload.github.com/iprak/winix/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iprak%2Fwinix/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28862191,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-28T22:56:21.783Z","status":"online","status_checked_at":"2026-01-29T02:00:06.714Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["home-assistant","homeassistant","purifier","winix"],"created_at":"2026-01-29T04:29:56.142Z","updated_at":"2026-05-03T00:04:42.020Z","avatar_url":"https://github.com/iprak.png","language":"Python","funding_links":["https://buymeacoffee.com/leolite1q"],"categories":[],"sub_categories":[],"readme":"\n![GitHub Release](https://img.shields.io/github/v/release/iprak/winix)\n[![License](https://img.shields.io/packagist/l/phplicengine/bitly)](https://packagist.org/packages/phplicengine/bitly)\n\u003ca href=\"https://buymeacoffee.com/leolite1q\" target=\"_blank\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" height=\"20px\"\u003e\u003c/a\u003e\n\n## Summary\n\nA custom component to interact with Winix air purifiers and dehumidifiers.\n\nAir purifiers: confirmed on [C545](https://www.winixamerica.com/product/certified-refurbished-c545-air-purifier/) and [C610](https://www.winixamerica.com/product/c610/), and reported to work on [AM90](https://www.winixamerica.com/product/am90/), [HR1000](https://www.amazon.com/Winix-HR1000-5-Stage-Enabled-Cleaner/dp/B01FWS0HSY), [C909](https://www.costco.com/winix-c909-4-stage-air-purifier-with-wi-fi-%2526-plasmawave-technology.product.100842491.html), [T800](https://winixeurope.eu/air-purifiers/winix-t800-wifi/), [T810](https://www.winixamerica.com/product/t810/), [5510](http://winixamerica.com/product/5510/), [5520](http://winixamerica.com/product/5520/), [9800](https://www.winixamerica.com/product/9800/) — functionality may vary by model.\n\nDehumidifiers: confirmed on [DXWE210](https://www.winix.com/product/1689) (Korean page). Other models in the `DXW*21*` family are likely compatible.\n\n## Installation\n\nThis can be installed by copying all the files from `custom_components/winix/` to `\u003cconfig directory\u003e/custom_components/winix/`. Next add Winix integration from `Add Integration` and use your credentials from Winix mobile app.\n\n### Air Purifier\n\n- C545 will generate 4 entities.\n- C610 will generate 6 entities.\n\n\u003cimg width=\"200\" alt=\"image\" src=\"https://github.com/user-attachments/assets/4ce73077-ae01-4c7f-9aa4-2c0cf769fbf3\" /\u003e\n\n\u003cimg width=\"200\" alt=\"image\" src=\"https://github.com/user-attachments/assets/152b668e-256b-4798-a080-0cf6d05b998b\" /\u003e\n\n\n- The `Air QValue` sensor reports the qValue reported by Winix purifier. This value is related to air quality although I am not exactly sure what it represents.\n- The `AQI` sensor matches the led light on the purifier.\n  - Good (Blue) = 1\n  - Fair (Amber) = 2\n  - Poor (Red) = 3\n- The `Filter Life` sensor represents the left filter life and is based on an initial life of 9 months.\n- The `PM 2.5` sensor is exposed only on devices that report particulate readings (e.g., T800).\n\n- The fan entity supports speed and preset modes\n- The `Child Lock` switch toggles the device's child lock, exposed only on devices that report support for the feature.\n\n![image](https://user-images.githubusercontent.com/6459774/212468432-0b37cd09-af5b-418c-855d-a12c8b21efc3.png)\n\n- The device data is fetched every 30 seconds.\n- There are 4 services `winix.plasmawave_off, winix.plasmawave_on, plasmawave_toggle and remove_stale_entities` in addition to the default fan services `fan.speed, fan.toggle, fan.turn_off, fan.turn_on, fan.set_preset_mode`.\n  - `remove_stale_entities` can be used to remove entities which appear unavaialble when the associated device is removed from the account.\n\n\n#### Brightness Level\nIf the purifiers support this feature, then you will see a selection list under the device.\n\n- Winix only supports updating the brightness level when the purifier is running.\n- The last brightness level is exposed as the attribute `last_brightness_level` on the fan.\n\n\n### Dehumidifier\n\n- DXWE210 will generate 7 entities.\n\n\u003cimg width=\"200\" alt=\"dehumidifier_entities\" src=\"https://github.com/user-attachments/assets/351e9887-8d8b-4ad7-a360-77662e991473\" /\u003e\n\n- The `humidifier` entity is the primary control for the dehumidifier device.\n  - Powers the device on or off.\n    - Treats the `auto-dry` power state as off. It is represented by the `Auto Dry` binary sensor.\n  - Sets the operating mode: `Auto`, `Manual`, `Clothes`, `Shoes`, `Quiet`, or `Continuous`.\n  - Sets the target humidity, in the 35–70 % range with 5 % steps.\n  - Reports the current humidity from the device's sensor.\n- The `Fan Speed` select sets the fan to `low`, `high`, or `turbo`.\n- The `Auto Dry` binary sensor reflects the internal drying cycle, which runs while the device is powered off.\n- The `Water Tank` binary sensor reports a problem state when the tank is full or detached.\n- The `Timer` number entity sets an off-timer between 0 and 24 hours.\n- The `Child Lock` switch toggles the device's child lock, exposed only on devices that report support for the feature.\n- The `UV Sanitize` switch toggles UV sanitization, exposed only on devices that report support for the feature.\n\n### Note\n\n- If devices are added/removed, then you would have to reload the integration.\n\n- Winix **does not support** simultaneous login from multiple devices. If you logged into the mobile app after configuring HomeAssistant, then the HomeAssistant session gets flagged as invalid and vice-versa.\n\n  - To maintain access to both the app and Home Assistant, you can set up a second account. Use this second account for Home Assistant while keeping your main account logged in on your mobile app.\n\n    Create a second Winix account with no devices linked. Then from your main account, navigate to `Device Settings \u003e Device Sharing \u003e Add a user` and invite the second account.\n\n\n## Breaking Changes\n\n- [1.1.0](https://github.com/iprak/winix/releases) changed the sensor implementation. The aqi sensor id might be different now.\n\n- [1.0.0](https://github.com/iprak/winix/releases) introduces config flow and previous yaml based setup is no longer supported. You would want to delete that setup and proceed to setup the intgeration as mentioned in `Installation` section.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiprak%2Fwinix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiprak%2Fwinix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiprak%2Fwinix/lists"}