Home Assistant: LG SmartThinQ Component

A Home Assistant component for controlling LG HVAC devices via their SmartThinQ platform, based on WideQ. The current version of the component requires Home Assistant 0.96 or later.

Here's how to use this:

1. Clone this repository into your ~/.homeassistant directory under custom_components and name it smartthinq. For example, you might do something like this:

   $ cd ~/.homeassistant
   $ mkdir custom_components
   $ cd custom_components
   $ git clone https://github.com/sampsyo/hass-smartthinq.git smartthinq
   

2. Navigate to the WideQ directory. You can either use the copy installed by Home Assistant, or clone it separately by typing something like:

   $ git clone https://github.com/sampsyo/wideq.git
   $ cd wideq
   

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

   $ python3 example.py -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 write a JSON file called wideq_state.json.

   Look inside this file for a key called "refresh_token" and copy the value.

3. Add a stanza to your Home Assistant configuration.yaml like this:

   climate:
       - platform: smartthinq
         refresh_token: YOUR_TOKEN_HERE
         country: US
         language: en-US
   

   Use your refresh token and country & language codes. Start up Home Assistant and hope for the best.

Credits

This is by Adrian Sampson. The license is MIT.