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