Homebridge Navien Smart

🇺🇸 English | 🇰🇷 한국어

Overview

Homebridge plugin to control Navien devices via Navien Smart.

A plugin for interacting with the "Navien Smart" system, which can control Navien devices. API used in this plugin is not official, I reversed from their "Navien Smart" mobile app.

⚠️ Warning

This plugin is only tested with Navien EME520 model. It may not work with other models. If you have a different model, please comment on this issue to support your model.

See Implementation Status for more information.

Installation

npm i -g homebridge-navien-smart

Configuration

{
    "authMode": "account",
    "username": "<navien-smart-username>",
    "password": "<navien-smart-password>",
    "accessoryType": "HeaterCooler",
    "platform": "NavienSmart"
}

{
    "authMode": "token",
    "username": "<navien-smart-username>",
    "refreshToken": "<navien-api-refresh-token>",
    "accountSeq": 12345678,
    "accessoryType": "HeaterCooler",
    "platform": "NavienSmart"
}

| Key | Description | | --- | --- | | authMode | Required. You can choose between token and account | | username | Required. Navien Smart account | | password | Required if authMode = account. Navien Smart password | | refreshToken | Required if authMode = token. You can get it with navien cli. | | accountSeq | Required if authMode = token. You can get it with navien cli. | | accessoryType | Required. You can choose between HeaterCooler and Thermostat | | platform | value always NavienSmart |

If you don't want to put your password in the config, you can use authMode = token and use refreshToken and accountSeq instead.

You can get refreshToken and accountSeq with navien cli. See CLI Usage.

CLI Usage

$ navien
Usage: navien <username> <password>

$ npm install -g homebridge-navien-smart
$ navien <your-username> <your-password>
Logging in with username: <your-username>, password: <your-password>
refreshToken: XXXXXXXXXXX.XXXXXXXXX.XXXXXXXXX
accountSeq: 12345678

You can copy and paste refreshToken and accountSeq to your config.

Demo

Siri (Voice Control)

Widget (Home app / Control Center)