https://github.com/ohmantics/homebridge-airmega
Homebridge plugin for the Coway Airmega air purifier series
https://github.com/ohmantics/homebridge-airmega
airmega coway coway-iocare homebridge iocare
Last synced: 8 months ago
JSON representation
Homebridge plugin for the Coway Airmega air purifier series
- Host: GitHub
- URL: https://github.com/ohmantics/homebridge-airmega
- Owner: ohmantics
- Fork: true (mroth/homebridge-airmega)
- Created: 2022-11-02T22:09:15.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-09-23T00:45:09.000Z (over 2 years ago)
- Last Synced: 2024-11-08T12:50:59.963Z (over 1 year ago)
- Topics: airmega, coway, coway-iocare, homebridge, iocare
- Language: TypeScript
- Homepage:
- Size: 593 KB
- Stars: 12
- Watchers: 3
- Forks: 2
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# homebridge-airmega
Control and monitor your Airmega purifier with HomeKit.
[](https://npmjs.org/package/@ohmantics/homebridge-airmega) [](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
## Functionality
* Control power, fan speed, and lights
* Toggle between manual and auto mode
* Reports the current air quality
* Reports the life levels and change indication for the pre-filter and Max2 filter.
## Prerequisites
* Installation of [Homebridge](https://github.com/nfarina/homebridge)
* iOS 11 or later
* Airmega AP-1512HHS, 250S, 300S, or 400S connected to WiFi and registered with the IOCare app.
## Installation
```
npm install -g homebridge-airmega
```
## Configuration
Use the plugin [settings pane](https://www.npmjs.com/package/homebridge-config-ui-x) or add the following to your homebridge config:
```
"platforms": [
{
"platform": "Airmega",
"username": "myusername",
"password": "password123"
}
]
```
### Excluding Accessories
You can optionally prevent certain accessories from being created by using the `exclude` option in your config (note: only the lightbulb accessory supports exclusion for now).
Example:
```
"platforms": [
{
"platform": "Airmega",
"username": "myusername",
"password": "password123",
"exclude": [
"lightbulb"
]
}
]
```
### Authentication
The IOCare app offers two main options for logging in: "Phone Number/Email" or "Coway ID". The username and password you supply in the config has been tested to work with either one. This plugin currently does not support authentication through social networks.
## Tested Siri Commands
Example of some Siri commands you can use:
* "Turn on the air purifier"
* "Turn off the air purifier lights"
* "Set the air purifier to auto"
* "Set the air purifier fan to medium"
* "What's the air quality in \?"
## Notes
* If you have a IconS or other models not listed above, we'd like to [hear](https://github.com/ohmantics/homebridge-airmega/issues) from you.
* The Coway servers will ask you to change your password every 60 days. The plugin always defers that request.
* HomeKit will only display the status of one filter per purifier in the accessory details. It appears to choose randomly which filter it shows, however the filter change notification will appear if any filter needs changing. We've filed feedback with Apple to improve this.