lg-thinq

Safe
Smart Home & IoT

Control LG smart appliances: fridge, washer, dryer, AC.

SKILL.md

# LG ThinQ Skill Control LG smart home appliances via the ThinQ Connect API. ## Setup 1. Get a Personal Access Token from https://connect-pat.lgthinq.com 2. Store token: `echo "YOUR_TOKEN" > ~/.config/lg-thinq/token` 3. Store country code: `echo "MX" > ~/.config/lg-thinq/country` ## Quick Commands All scripts are in the skill's `scripts/` directory. Activate venv first: ```bash cd ~/clawd && source .venv/bin/activate ``` ### List Devices ```bash python3 skills/lg-thinq/scripts/thinq.py devices ``` ### Get Device Status ```bash python3 skills/lg-thinq/scripts/thinq.py status <device_id> python3 skills/lg-thinq/scripts/thinq.py status fridge # alias ``` ### Control Refrigerator ```bash # Set fridge temperature (0-6°C) python3 skills/lg-thinq/scripts/thinq.py fridge-temp 3 # Set freezer temperature (-24 to -14°C typical) python3 skills/lg-thinq/scripts/thinq.py freezer-temp -15 # Toggle express fridge python3 skills/lg-thinq/scripts/thinq.py express-fridge on|off # Toggle express freeze python3 skills/lg-thinq/scripts/thinq.py express-freeze on|off # Toggle eco mode python3 skills/lg-thinq/scripts/thinq.py eco on|off ``` ### Washer/Dryer Status ```bash python3 skills/lg-thinq/scripts/thinq.py status washer python3 skills/lg-thinq/scripts/thinq.py status dryer ``` ## Supported Devices | Device | Status | Control | |--------|--------|---------| | Refrigerator | ✅ temp, door, modes | ✅ temp, express, eco | | WashTower Washer | ✅ state, time | ⚠️ limited | | WashTower Dryer | ✅ state, time | ⚠️ limited | | Air Conditioner | ✅ temp, mode | ✅ temp, mode, fan | ## Temperature Ranges - **Fridge**: 0°C to 6°C - **Freezer**: -24°C to -14°C (varies by model) ## Error Handling - `NOT_CONNECTED_DEVICE`: Device offline, check WiFi or open ThinQ app - `INVALID_COMMAND_ERROR`: Wrong command format or value out of range - `NOT_PROVIDED_FEATURE`: Feature not supported by this model ## Natural Language Examples User says → Action: - "check my fridge" → `status fridge` - "set fridge to 5 degrees" → `fridge-temp 5` - "turn on express freeze" → `express-freeze on` - "is the fridge door open?" → `status fridge` (check doorStatus) - "how's the washer doing?" → `status washer`

More in Smart Home & IoT