The goal of this project is to de-cloud LG ThinQ-branded appliances, meaning to communicate with them without using the official LG app and cloud service. The project is developed by reverse engineering various components of the ThinQ ecosystem.

A working version of rethink-cloud is now available. This is a service which emulates the cloud part of ThinQ and translates the protocol to HomeAssistant-compatible MQTT.

An optional "bridge" mode is also supported, in which the messages are forwarded to the actual LG ThinQ cloud. This can be used as a reverse-engineering aid, or simply to allow the user to still use the original LG app alongside HomeAssistant.

The following appliances are currently supported in rethink:

• Air Conditioners:
  • 👍 LG DualCool family (Standard 2, Deluxe with and without air purifier, etc.) wall-mounted Air Conditioner IDUs - high level of support. What's missing are mostly some features of higher-end models, energy reporting for Single devices and more diagnostic coverage,
  • 👍 LW1822HRSM, Smart Window Air Conditioner - mostly working,
  • 👍 LP1022FVSM Portable Air Conditioner - mostly working,
• Fridges:
  • 🫤 LF28H8330S, Standard-Depth 4-Door French Door Refrigerator - preliminary support,
  • 🫤 GSJV70PZTE, LG Side by Side Refrigerator - preliminary support,
  • 🫤 GSB470BASZ, American Style Side by Side Refrigerator - preliminary support,
  • 🫤 GA-B509CMUM - preliminary support,
• Washing Machines:
  • 🫤 (model name unknown) Washing Machine - preliminary support
  • 👍 F2J7HG1W, Washing Machine - mostly working,
  • 🫤 F4WV709P1E, Front-Loading Washing Machine - preliminary support
  • 🫤 TW4V9RW9W - preliminary support

The supported appliances can be used "out of the box" with HomeAssistant or another compatible MQTT consumer.
Appliances not listed above can still be used with the bridge mode, but they will not be translated to MQTT. Contributions are welcome!

Most of the findings from the reverse engineering process are available on the project wiki as well.

See the instructions.

A simple web interface is available on a user-defined port (default: 44401). The interface supports:

• listing the devices connected to rethink
• monitoring their communications (with packet injection)
• configuring the bridge mode

The following code is currently available:

• rethink-setup - a simple tool to perform the "initial setup" from a Wi-Fi connected PC, without using the official LG app
• rethink-cloud - a server that replaces LG's cloud service. It's meant to be installed on your local network and hosts its own simplistic MQTT broker.

Miscelanneous utilities:

• packet-parser - an utility to interpret TLV-formatted packets received from the appliance via MQTT. It connects to rethink-cloud
• packet-sender - an utility to create TLV-formatted packets & send them via MQTT to the appliance. It connects to rethink-cloud
• appliance simulator - a program which allows the Wi-Fi module to be operated without connection to an appliance. It simulates a minimum set of UART responses to activate the Wi-Fi module.
• lgcloud-monitor - connects to the official LG cloud just like the official app would and displays real-time notifications about your devices straight from the MQTT feed. Useful for understanding how the LG cloud processes device updates.
• rethink-capture - records a device's live wire traffic (and optionally the time-aligned LG cloud notifications) to a JSONL capture file, with inline annotations, for offline reverse-engineering in an LLM-friendly format.
• mcp-server - an MCP server that exposes the reverse-engineering toolkit (decode/encode packets, enumerate devices, capture device & cloud traffic, inject and probe packets) to an LLM agent.

LG ThinQ is likely a registered trademark, or whatever, I don't care. The name is used here for identification purposes only. I'm not in any way affiliated with LG.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

This means that if your device breaks, you get to fix it yourself or keep both pieces.