Skip to content

reverse-engineered client for the LG SmartThinQ API. The fork is to add MQTT functionality so as to send the status to OpenHab or other HA solutions so that the messages can be parsed and the appropriate status can be displayed there

License

arunsudhakar/wideq

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PyPI CircleCI

WideQ

⚠️ New users of LG SmartThinq: This library only works with v1 of the LG SmartThinq API. Work is currently underway to support the v2 API, and the discussion can be found here. If you recently created a LG SmartThinq account, this library will likely return 0 devices when you execute the ls command.

A library for interacting with the "LG SmartThinq" system, which can control heat pumps and such. I reverse-engineered the API from their mobile app.

To try out the API, there is a simple command-line tool included here, called example.py. To use it, provide it with a country and language code via the -c and -l flags, respectively:

$ python3 example.py -c US -l en-US

LG accounts seem to be associated with specific countries, so be sure to use the one with which you originally created your account. For Korean, for example, you'd use -c KR -l ko-KR.

On first run, the script will ask you to log in with your LG account. Logging in with Google does not seem to work, but other methods (plain email & password, Facebook, and Amazon) do.

By default, the example just lists the devices associated with your account. You can also specify one of several other commands:

  • ls: List devices (the default).
  • mon <ID>: Monitor a device continuously, printing out status information until you type control-C. Provide a device ID obtained from listing your devices.
  • ac-mon <ID>: Like mon, but only for AC devices---prints out specific climate-related information in a more readable form.
  • set-temp <ID> <TEMP>: Set the target temperature for an AC or refrigerator device.
  • set-temp-freezer <ID> <TEMP>: Set the target freezer temperature for a refrigerator.
  • turn <ID> <ONOFF>: Turn an AC device on or off. Use "on" or "off" as the second argument.
  • ac-config <ID>: Print out some configuration information about an AC device.

Credits

This is by Adrian Sampson. The license is MIT. I also made a Home Assistant component that uses wideq.

About

reverse-engineered client for the LG SmartThinQ API. The fork is to add MQTT functionality so as to send the status to OpenHab or other HA solutions so that the messages can be parsed and the appropriate status can be displayed there

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%