# homebridge-airconditioner-mitsubishi-au-nz > Control your Mitsubishi Aircon units with Homebridge and Apple HomeKit Latest version **1.2.6** (published 2021-07-30) · Apache-2.0 license · 0 weekly downloads ## Install ```sh npm install homebridge-airconditioner-mitsubishi-au-nz pnpm add homebridge-airconditioner-mitsubishi-au-nz yarn add homebridge-airconditioner-mitsubishi-au-nz bun add homebridge-airconditioner-mitsubishi-au-nz ``` ## Health **Score 15/100 (F)** — status: abandoned. Positive: no vulnerabilities. Warnings: low downloads; no types; no esm support. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 1.2.6 | | Published | 2021-07-30 | | First published | 2021-07-03 | | Weekly downloads | 0 | | License | Apache-2.0 | | TypeScript types | none | | Module format | CommonJS | | Node | >=10.17.0 | | Dependencies | 5 | | Unpacked size | 1 MB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 11 | | Maintainers | aurc | | Keywords | homebridge-plugin | ## Links - npm: https://www.npmjs.com/package/homebridge-airconditioner-mitsubishi-au-nz - Repository: https://github.com/aurc/melview-mitsubishi-au-nz - Homepage: https://github.com/aurc/melview-mitsubishi-au-nz#readme - Issues: https://github.com/aurc/melview-mitsubishi-au-nz/issues - Funding: https://www.paypal.com/paypalme/aureliocalegari - npm.io page: https://npm.io/package/homebridge-airconditioner-mitsubishi-au-nz ## Dependencies (5) - [path](https://npm.io/package/path.md) ^0.12.7 - [node-fetch](https://npm.io/package/node-fetch.md) ^2.6.1 - [tough-cookie](https://npm.io/package/tough-cookie.md) ^4.0.0 - [@types/node-fetch](https://npm.io/package/@types/node-fetch.md) ^2.5.10 - [@types/tough-cookie](https://npm.io/package/@types/tough-cookie.md) ^4.0.0 ## Alternatives - [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads - [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads - [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads - [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads - [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads ## Recent versions - 1.2.6 (latest) — 2021-07-30 - 1.0.3-beta.0 (beta) — 2021-07-03 - 1.2.5 — 2021-07-11 - 1.2.3 — 2021-07-09 - 1.2.2 — 2021-07-07 - 1.2.1 — 2021-07-06 - 1.2.0 — 2021-07-06 - 1.1.1 — 2021-07-05 - 1.0.7 — 2021-07-04 - 1.0.6 — 2021-07-04 - 1.0.5 — 2021-07-03 - 1.0.3-beta.1 — 2021-07-03 - 1.0.2-beta.0 — 2021-07-03 - 1.0.1-beta.0 — 2021-07-03 ## README

# Homebridge Melview AU/NZ Airconditioners [![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins) [![npm](https://img.shields.io/npm/v/homebridge-airconditioner-mitsubishi-au-nz/latest?label=latest)](https://www.npmjs.com/package/homebridge-airconditioner-mitsubishi-au-nz) [![GitHub release](https://img.shields.io/github/release/aurc/melview-mitsubishi-au-nz.svg)](https://github.com/aurc/melview-mitsubishi-au-nz/releases) [![npm](https://img.shields.io/npm/dt/homebridge-airconditioner-mitsubishi-au-nz)](https://www.npmjs.com/package/homebridge-airconditioner-mitsubishi-au-nz) [![Github CI](https://github.com/aurc/melview-mitsubishi-au-nz/actions/workflows/build.yml/badge.svg)](https://github.com/aurc/melview-mitsubishi-au-nz/actions) [![Github CD](https://github.com/aurc/melview-mitsubishi-au-nz/actions/workflows/release.yml/badge.svg)](https://github.com/aurc/melview-mitsubishi-au-nz/actions) [![Hex.pm](https://img.shields.io/hexpm/l/plug)](https://www.apache.org/licenses/LICENSE-2.0) Use this plugin to integrate your Mitsubishi Airconditioner appliances with Apple's HomeKit using Homebridge. ## Overview This plugin allows you to control the basic functionalities of your AC units through the home app and Siri. The features include: - Instant unit response - update the unit directly via LAN interface & cloud Melview. - Automatically find all appliances linked to your account; - Control power ON/OFF - Set mode AUTO, HEAT, COOL - Dehumidifier (DRY): **Experimental**, disabled by default, use with caution as this feature is not extensively tested. - Set desired temperature - Obtain unit status, e.g. power, mode, room temperature and desired temperature. This project is a hobby project and was created to address the need for a stable plugin in AU/NZ to control Mitsubishi Air Conditioners. It was possible due to the great reverse engineering effort done by these folks: [NovaGL/diy-melview](https://github.com/NovaGL/diy-melview). Also note that the [Homebridge](https://homebridge.io/) put together excellent developer documentation which made it possible to get up and running quickly (e.g. [plugin-temeplate](https://github.com/homebridge/homebridge-plugin-template))! ## Compatibility & Pre-requisites It should work with most modern Mitsubishi Electric Airconditioner units that are Wi-Fi capable. This plugin has been developed and tested against the following products: | Model | Wi-Fi Module | | -------------------------------------------------------------------------------------------------- | ----------------------------------------------- | | [MSZ-GL71VGD](https://www.mitsubishielectric.com.au/assets/LEG/JG79A991H01-UM.pdf) | [MAC-568IF-E](https://www.mitsubishielectric.com.au/assets/LEG/MAC-568IF-E.pdf) | | [MSZ-GL35VGD](https://www.mitsubishielectric.com.au/assets/LEG/JG79A991H01-UM.pdf) | [MAC-568IF-E](https://www.mitsubishielectric.com.au/assets/LEG/MAC-568IF-E.pdf) | | [MSZ-AP25VGD](https://www.mitsubishielectric.com.au/assets/LEG/MSZ-AP-User-Manual-JG79Y333H01.pdf) | [MAC-568IF-E](https://www.mitsubishielectric.com.au/assets/LEG/MAC-568IF-E.pdf) | In a nutshell, if you were able to install the **[Wi-Fi Control App](https://apps.apple.com/au/app/mitsubishi-wi-fi-control/id796225889#?platform=iphone)** and operate the unit, this plugin is for you! Netheless to say, you should have **[Homebridge](https://homebridge.io/)** running. ## Coming Soon Some capabilities are not yet available and should be released soon: - Fan (FAN) mode; - Swing; ## Known issues - **Dry mode**: Does not control fan speed. - **LAN access**: Still requires internet connection, as it authenticates the requests with Melview cloud. It still operates way faster than Alexa and Goolge home integration as it has a fast follower command locally removing the know lag. ## Installation ### Through Homebridge Config UI (recommeded) It's highly recommended that you use the [Homebridge Config UI X](https://github.com/oznu/homebridge-config-ui-x). 1. Access the settings and configure the credentials as per the required fields. 2. Save and restart homebridge. 3. All units in your network should be automatically recognised. Open your Home App and allocate them to their respective rooms. ### Through CLI You can install the package manually by issuing: ```` npm install -g homebridge-airconditioner-mitsubishi-au-nz ```` and configuring the plugin file `config.json` as: ```` { "bridge": { //... }, "accessories": [], "platforms": [ { "user": "user@domain.com", "password": "yourpassword", "platform": "MitsubishiAUNZ" } ] } ```` where **user** is your user name, typically the email you used to register with the app and **password** is your account password. ## Questions & Issues If you have issues, found a bug or have a question, please open an issue **[here](https://github.com/aurc/melview-mitsubishi-au-nz/issues)**. --- _Source: https://npm.io/package/homebridge-airconditioner-mitsubishi-au-nz · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._