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:

cd ~/clawd && source .venv/bin/activate

List Devices

python3 skills/lg-thinq/scripts/thinq.py devices

Get Device Status

python3 skills/lg-thinq/scripts/thinq.py status <device_id>
python3 skills/lg-thinq/scripts/thinq.py status fridge  # alias

Control Refrigerator

# 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

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