NorDroN / homebridge-wideq

MIT License
12 stars 5 forks source link

homebridge-wideq

A Homebridge plugin for controlling/monitoring LG devices via their SmartThinQ platform, based on WideQ.

Here's how to use this:

  1. Install the homebridge-wideq plugin:

    $ npm install -g homebridge-wideq wideq
  2. Get refresh token:

    Authenticate with the SmartThinQ service to get a refresh token by running the WideQ script (Eventually, I would like to add a feature to the Homebridge plugin that can let you log in through a UI, but I haven't gotten there yet.):

    $ wideq auth -c US -l en-US

    For the -c and -l parameters, use your country and language code: SmartThinQ accounts are associated with a specific locale, so be sure to use the country you originally created your account with. The script will ask you to open a browser, log in, and then paste the URL you're redirected to. It will then show "Refresh token: [YOUR_TOKEN_HERE]" and write a JSON file called wideq_state.json. Copy the value.

  3. Add the plugin to your config.json:

    {
        "platform": "WideQ",
        "refresh_token": [YOUR_TOKEN_HERE],
        "country": "US",
        "language": "en-US",
        "debug": false,
        "interval": 10
    }

    Use your refresh token and country & language codes. If region and language are not provided, then 'US' and 'en-US' are default.

Implementation Status

Device Implementation Status Control
AC :heavy_check_mark: :warning: needs testing :warning: needs testing
Refrigerator :heavy_check_mark: :heavy_check_mark: :heavy_check_mark:
Washer :heavy_check_mark: :warning: needs testing :warning: needs testing