{"id":20356396,"url":"https://github.com/haywirecoder/homebridge-frigidaire-dehumidifier","last_synced_at":"2025-08-31T03:38:07.598Z","repository":{"id":59360334,"uuid":"535487939","full_name":"haywirecoder/homebridge-frigidaire-dehumidifier","owner":"haywirecoder","description":"Homebridge Frigidaire Dehumidifier ","archived":false,"fork":false,"pushed_at":"2024-05-11T14:10:42.000Z","size":125,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-25T22:35:40.277Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/haywirecoder.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}},"created_at":"2022-09-12T02:40:54.000Z","updated_at":"2024-08-25T02:35:55.000Z","dependencies_parsed_at":"2024-03-21T01:44:56.553Z","dependency_job_id":null,"html_url":"https://github.com/haywirecoder/homebridge-frigidaire-dehumidifier","commit_stats":{"total_commits":38,"total_committers":1,"mean_commits":38.0,"dds":0.0,"last_synced_commit":"3e379e94c723ea4731b0b477f0dd65c2d71a5bf1"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haywirecoder%2Fhomebridge-frigidaire-dehumidifier","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haywirecoder%2Fhomebridge-frigidaire-dehumidifier/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haywirecoder%2Fhomebridge-frigidaire-dehumidifier/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haywirecoder%2Fhomebridge-frigidaire-dehumidifier/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/haywirecoder","download_url":"https://codeload.github.com/haywirecoder/homebridge-frigidaire-dehumidifier/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248351462,"owners_count":21089271,"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":[],"created_at":"2024-11-14T23:16:19.521Z","updated_at":"2025-08-31T03:38:07.591Z","avatar_url":"https://github.com/haywirecoder.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![NPM Version](https://img.shields.io/npm/v/homebridge-frigidaire-dehumidifier.svg?style=flat-square)](https://www.npmjs.com/package/homebridge-frigidaire-dehumidifier)\n[![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)\n\n\n\u003cp align=\"center\"\u003e\n \n\u003cimg src=\"https://github.com/homebridge/branding/blob/latest/logos/homebridge-color-round-stylized.png\" width=\"150\"\u003e\n\n\u003c/p\u003e\n\n\n# Homebridge Plug-In for Frigidaire Dehumidifier\nAn Homebridge plug-in to integrate the Frigidaire's connected dehumidifier with HomeKit. It monitors and control devices via the Frigidaire unofficial cloud API. Thanks to the Frigidaire Python API  https://github.com/bm1549/frigidaire developers and https://github.com/karlg100/frigidaire , this module uses logic and code gain from reviewing those works.\nFrigidaire updated their API to v3 in June 2023 and deprecated v2 in February 2024, meaning the plug-in engine had to be re-written. Upgrade to version 2+ may impact previous automation or setting. This is a one time event to support Frigidaire v3 API.\n\n\n\n## Limitation:\n* This module will poll for the status of the various components based frequency provided in the configuration file. No realtime notification is provided.\n* This is known to work with model FGAC5045W1 and FHDD5033W1 (limited testing/support). \n\n\n## Configuration options\n\n| Attributes        | Description                                                                                                              |\n| ----------------- | ------------------------------------------------------------------------------------------------------------------------ |\n| username              | Frigidaire username. This is a required value.                    |\n| password              | Frigidaire password. This is a required value.                                                                 |\n| deviceRefresh        | Polling interval to obtain status of Frigidaire appliance, provided in seconds. Default to \u003ci\u003e90\u003c/i\u003e seconds, this is an optional value. \u003cb\u003ePlease note:\u003c/b\u003e Small values may cause account lock or frequent API errors.                                                                    |\n| dehumidifierMode          | Homekit only has two mode dehumidifying modes \"Auto\" and \"Dehumidifying\". When \"Dehumidifying\" is selected in Homekit the selection is map to a specific Frigidaire appliance mode: \"Quiet\", \"Dry\" or \"Continuous\". \u003cp\u003e\u003cp\u003eValid string values are the following: \u003cbr\u003e\"Dry\"\u003cbr\u003e\"Continuous\"\u003cbr\u003e\"Quiet\"\u003cp\u003eThe default mode for is Frigidaire \"Dry\" mode. This an optional value.  \n| enableAirPurifier | Create additional accessory for Air purifier/Ionizer functionality. Only available in limited models. Default to \u003ci\u003etrue\u003c/i\u003e, this is an optional value.    \n| enablePumpSwitch | Create additional accessory to control water pump. Only available in limited models. Default to \u003ci\u003etrue\u003c/i\u003e, this is an optional value.                                                         \n| excludedDevices         | Devices IDs to suppress from HomeKit. The device IDs can be obtain from Homebridge logs at startup of this plug-in. This is an optional value. | |\n\n\n## 💧 Note: Dehumidifier Relative Humidity\n\nThere is a difference between Frigidaire App and Homebridge/HomeKit for relative humidity. \n\nHomeKit Relative Humidity work between 0%-100% (By design). Here is translation between Frigidaire and Homekit.\n\n| Frigidaire | HomeKit |\n| --- | --- |\n| 35% | 0% |\n| 40% | 10% |\n| 45% | 20% |\n| 50% | 30% |\n| 55% | 40% |\n| 60% | 50% |\n| 65% | 60% |\n| 70% | 70% |\n| 75% | 80% |\n| 80% | 90% |\n| 85% | 100% |\n\n\nExample configuration is below, with Frigidaire dehumidifier mode set to \u003ci\u003eQuiet\u003c/i\u003e mode for dehumidifying and Air purifier/Ionizer set to display in Homekit. \n\n```javascript\n...\n\n\"platforms\": [\n{\n    \"name\": \"FrigidaireAppliance\",\n    \"auth\": {\n        \"username\": \"\u003cusername\u003e\",\n        \"password\": \"\u003cpassword\u003e\"\n      },\n      \"deviceRefresh\": 90,\n      \"dehumidifierMode\": \"Quiet\",\n      \"enableAirPurifier\": true,\n      \"platform\": \"FrigidaireAppliance\"\n}\n...]\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhaywirecoder%2Fhomebridge-frigidaire-dehumidifier","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhaywirecoder%2Fhomebridge-frigidaire-dehumidifier","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhaywirecoder%2Fhomebridge-frigidaire-dehumidifier/lists"}