1
0
mirror of https://github.com/no2chem/wideq.git synced 2025-05-16 07:10:09 -07:00
2019-11-28 09:34:51 -05:00
2019-06-30 14:17:32 -04:00
2019-08-12 09:37:22 -04:00
2019-11-27 11:31:09 -05:00
2019-06-28 11:31:10 -07:00
2019-11-28 09:34:51 -05:00
2018-01-06 14:33:55 -08:00
2019-07-08 22:39:52 -04:00
2019-06-30 11:02:48 -04:00

PyPI CircleCI

WideQ

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 device.
  • 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.

Description
reverse-engineered client for the LG SmartThinQ API
Readme MIT 382 KiB
Languages
Python 100%