Rethink Home Assistant Add-on

LG ThinQ 가전을 LG 클라우드 대신 로컬 Rethink 서버에 연결하고, MQTT Discovery를 통해 Home Assistant 기기로 등록하는 애드온입니다.

애드온 설치 빌드는 공개된 master 브랜치 소스를 사용합니다.

Home Assistant 애드온 주요 기능

• Home Assistant 애드온으로 Rethink 서비스 실행 및 자동 시작
• Supervisor에 등록된 MQTT 서비스 정보 자동 검색
• MQTT 자동 검색 실패 또는 비활성화 시 서버·사용자 ID·비밀번호 수동 설정
• 인증서, 브리지 상태, 런타임 설정 및 에어컨·냉장고의 소프트웨어 총 누적 전력량을 /data에 영구 보관
• Home Assistant ingress를 통한 관리 화면 접근
• Home Assistant 위치·시간대와 sun.sun을 사용하는 2RES2VE300UA2 야간 눈부심 방지 모드 설정
• 2RES2VE300UA2 스마트케어 상태 확인 및 검증된 ON/OFF 제어
• 2RES2VE300UA2 Pure N Fresh 운전·진단 상태 확인
• 2RES2VE300UA2 표시창 잠금 원시 상태 확인
• ThinQ 1 및 ThinQ 2 로컬 엔드포인트 제공
• AS121VRST (AIR_910604_WW) 실제 상태 기반 전원·풍속·쾌속·공기 제균·취침 예약 제어, PM 센서 및 필터 잔여 정보 확인

설치 및 설정

주의: 2RES2VE300UA2 야간 시작·종료 시간은 MQTT time 엔티티를 사용하므로 Home Assistant 2026.5 이상이 필요합니다. 일출/일몰 모드는 Home Assistant Core API와 sun.sun을 사용하며, 조회할 수 없으면 사용자 모드로 대체됩니다. 사용자 입력 시간은 Home Assistant 시간대의 로컬 시간으로 저장한 뒤 냉장고 프로토콜에 맞춰 UTC로 변환됩니다. 밝기 셀렉터는 0%, 10%, 30%, 50%, 80%, 100%만 전송합니다.

1. Home Assistant 애드온 스토어에 https://github.com/plplaaa2/rethink 저장소를 추가합니다.
2. Rethink 애드온을 설치합니다.
3. MQTT 자동 검색을 사용하거나 수동 MQTT 옵션을 입력합니다.
4. 공유기 또는 로컬 DNS에서 설정한 호스트 이름(기본값 rethink.home.arpa)이 Home Assistant 호스트를 가리키도록 구성합니다.
5. 애드온을 시작하고 웹 UI 열기에서 연결 상태를 확인합니다.

MQTT 자동 검색이 활성화되어 있으면 Supervisor가 제공하는 MQTT 연결 정보를 우선 사용합니다. MQTT 서비스가 없거나 정보를 가져오지 못하면 수동으로 입력한 mqtt_server, mqtt_username, mqtt_password 값으로 전환합니다.

Rethink 애드온은 MQTT Broker 애드온과의 호스트 포트 충돌을 피하기 위해 내부 포트 1884를 공개하지 않습니다. ThinQ 2 기기 연결에는 Rethink의 8883 포트가 필요하므로 MQTT Broker 애드온이 호스트 포트 8883을 사용 중이면 Broker 애드온 설정에서 해당 포트 공개를 제거해야 합니다. MQTT Broker의 일반 연결 포트 1883은 그대로 사용할 수 있습니다.

ipTIME 및 AdGuard Home 설정

다음은 Home Assistant가 192.168.1.102인 경우의 예시입니다. AdGuard Home 애드온은 Home Assistant 호스트에서 DNS를 제공하므로 DNS 서버 주소도 192.168.1.102를 사용합니다. AdGuard Home을 별도 장치나 VM에 설치한 경우에만 해당 설치 위치의 별도 IP를 사용하십시오.

1. ipTIME의 DHCP 고정 할당 기능으로 Home Assistant의 IP가 바뀌지 않도록 설정합니다. 독립 설치형 AdGuard Home을 사용한다면 해당 장치의 IP도 고정합니다.
2. ipTIME의 DHCP/DNS 설정에서 클라이언트에 배포할 DNS 서버를 AdGuard Home이 설치된 호스트 주소로 지정합니다. AdGuard Home 애드온이면 Home Assistant 주소(192.168.1.102), 독립 설치형이면 해당 장치의 주소를 사용합니다. 메뉴 이름은 ipTIME 펌웨어에 따라 다를 수 있습니다.
3. AdGuard Home의 필터 → DNS 재작성에서 rethink.home.arpa가 Home Assistant 주소(192.168.1.102)를 반환하도록 추가합니다.
4. common.lgthinq.com은 재작성하지 않습니다. Rethink 연결에는 설정 옵션의 호스트 이름만 재작성하면 됩니다.
5. AdGuard Home의 DNS 캐시를 비우고, 가전의 Wi-Fi를 다시 연결하거나 네트워크 설정을 초기화한 뒤 재등록합니다.

AdGuard Home 애드온 구성에서는 PC에서 nslookup rethink.home.arpa 192.168.1.102를 실행했을 때 Home Assistant 주소가 반환되어야 합니다. 독립 설치형은 명령의 DNS 서버 주소를 AdGuard Home 호스트 IP로 바꾸십시오. DNS가 정확해도 가전이 연결되지 않으면 ipTIME의 게스트 네트워크·AP 격리 기능이 꺼져 있는지, 필수 포트가 같은 LAN에서 차단되지 않는지 확인하십시오.

필수 포트와 상세 옵션은 애드온 사용 설명서를 참고하십시오. 가전 및 관리 포트를 인터넷에 직접 공개하지 마십시오.

AS121VRST 공기청정기의 구형 ThinQ 1 설정 AP, LG 앱 Wi-Fi 등록, 클라이언트별 DNS 재작성 및 브릿지 절차는 AS121VRST 등록 안내를 참고하십시오.

원본 Rethink 프로젝트

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.

Status

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 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,
  • 🫤 F4WV508S2E, Front-Loading Washing Machine - preliminary support
  • 🫤 F4WV709P1E, Front-Loading Washing Machine - preliminary support
  • 🫤 TW4V9RW9W - preliminary support
  • 👍 F4X7511TWS (VCDWL2QEUK), Front-Load Washing Machine - mostly working
  • 🫤 WT7300CW - preliminary support
  • 👍 WM3900HBA (F3L2CYU__), Front-Load Washing Machine - mostly working
• Air Purifiers:
  • 🫤 AS121VRST (AIR_910604_WW) - confirmed controls and filter telemetry only
• Dryers:
  • 🫤 DLE7300WE - preliminary support
  • 👍 DLEX3900B (RV13B6BSD_D_US_WIFI), Electric Dryer - mostly working
• WashTowers (combined washer+dryer):
  • 👍 WKEX200HBA (WTL_FXU_BDV_NA_01), WashTower - mostly working

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.

Installation

See the instructions.

Management

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

Code

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.

Notice

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.

Warning

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.