Skip to content

A Homebridge plugin for controlling/monitoring LG ThinQ device via their ThinQ platform.

License

Notifications You must be signed in to change notification settings

simplytoast1/homebridge-lg-thinq

 
 

Repository files navigation

Homebridge LG ThinQ

verified-by-homebridge npm npm

Overview

A Homebridge plugin for controlling/monitoring LG ThinQ device via their ThinQ platform.

⚠️ This library works with v2 of the LG ThinQ API. But some v1 device may backward compatible, please check table Implementation Status below.

A plugin for interacting with the "LG ThinQ" system, which can control new LG smart device. API used in this plugin is not official, I reversed from their "LG ThinQ" mobile app.

Installation

npm i -g homebridge-lg-thinq

Configuration

✔️ I highly recommend using homebridge-config-ui-x to make these changes.

  1. Navigate to the Plugins page in homebridge-config-ui-x.
  2. Click the Settings button for the LG ThinQ plugin.
  3. Login to your LG account
  4. Add or remove which devices you want
  5. Restart Homebridge for the changes to take effect.

⚠️ Or you can manual edit it, add json below to config.json (not recommend)

{
  "auth_mode": "token",
  "refresh_token": "**refresh*token**",
  "username": "lg username",
  "password": "lg password",
  "country": "US",
  "language": "en-US",
  "thinq1": false,
  "devices": [
	{
	  "id": "device id"
	}
  ],
  "platform": "LGThinQ"
}
  • auth_mode Required. You can choose between token and account
  • refresh_token Required if auth_mode = token. The refresh_token of your account.
  • username Required if auth_mode = account. LG thinQ account
  • password Required if auth_mode = account. LG thinQ password
  • country Required. Your account country alpha-2 code, e.g., US for the USA.
  • language Required. Your account language code, e.g., en-US, vi-VN.
  • devices List devices you want add to homebridge, leave it empty if you want add all devices.
  • thinq1 Optional. Enable thinq1 device support
  • platform value always LGThinQ

Implementation Status

Device Implementation Status Control Thinq2 Thinq1
Refrigerator ✔️ ✔️ ✔️ ✔️ 🚫
Air Purifier ✔️ ✔️ ✔️ ✔️ 🚫
Washer & Dryer ✔️ ✔️ 🚫 ✔️ ✔️
Dishwasher ✔️ ✔️ ✔️ ✔️ 🚫
Dehumidifier ✔️ ✔️ ⚠️ ✔️ 🚫
AC in development ⚠️ ⚠️ ⚠️ ⚠️

for more device support please open issue request.

Support

If you have a question, please start a discussion.
If you would like to report a bug, please open an issue.

About

A Homebridge plugin for controlling/monitoring LG ThinQ device via their ThinQ platform.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 77.4%
  • HTML 21.2%
  • JavaScript 1.4%