netatmo

name	netatmo
description	Control Netatmo thermostat and read weather station data. Use for heating control (set temperature, change mode), checking indoor/outdoor temperatures, CO₂ levels, humidity, noise, and pressure readings.

Netatmo

Control Netatmo smart home devices via netatmo CLI.

Setup

Credentials in ~/.config/netatmo/:

• credentials.json: {"client_id": "...", "client_secret": "..."}
• tokens.json: OAuth tokens (auto-refreshed)

Commands

netatmo status              # Full overview (thermostat + all sensors)
netatmo thermostat          # Thermostat details only
netatmo weather             # All sensors including Office
netatmo history             # 7-day temperature history with sparklines
netatmo history --days 14   # Custom period
netatmo set 21              # Set target temp (7-30°C, 3h manual mode)
netatmo mode schedule       # Resume schedule
netatmo mode away           # Away mode (12°C)
netatmo mode hg             # Frost guard (7°C)
netatmo <cmd> --json        # JSON output for any command

Available Data

Location	Temp	Humidity	CO₂	Noise	Pressure	Battery
Bedroom (main)	✓	✓	✓	✓	✓	—
Outdoor	✓	✓	—	—	✓*	✓
Living Room	✓	✓	✓	—	—	✓
Office	✓	—	—	—	—	—

*Pressure displayed with Outdoor (sensor in main station)

Notes

• CO₂ >1000 ppm = poor ventilation
• set uses manual mode for 3h, then reverts to schedule
• Tokens auto-refresh on expiry
• History shows ASCII sparklines for temperature trends