Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aschzero/homebridge-airmega
Homebridge plugin for the Coway Airmega air purifier.
https://github.com/aschzero/homebridge-airmega
homebridge homebridge-plugin
Last synced: 3 days ago
JSON representation
Homebridge plugin for the Coway Airmega air purifier.
- Host: GitHub
- URL: https://github.com/aschzero/homebridge-airmega
- Owner: aschzero
- Created: 2018-03-21T02:32:31.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2021-02-15T18:05:57.000Z (over 3 years ago)
- Last Synced: 2024-10-28T11:13:22.944Z (15 days ago)
- Topics: homebridge, homebridge-plugin
- Language: TypeScript
- Homepage:
- Size: 161 KB
- Stars: 34
- Watchers: 9
- Forks: 19
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-homebridge - Airmega
README
# homebridge-airmega
Control and monitor your Airmega purifier with HomeKit.
[](https://npmjs.org/package/homebridge-airmega)
## 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 400S or 300S connected to WiFi and registered with the IOCare app
## Installation
```
npm install -g homebridge-airmega
```
## Configuration
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 \?"