py-netatmo-truetemp-cli 1.0.2

Netatmo's missing true temperature CLI - set real room temps from your terminal

py-netatmo-truetemp-cli

Netatmo's missing true temperature CLI - set real room temps from your terminal with a simple, intuitive command-line interface.

⚠️ Disclaimer

Unofficial Project: This is an independent, community-developed CLI tool and is not affiliated with, endorsed by, or supported by Netatmo or Legrand.

Why This Exists: The official Netatmo OAuth API does not currently support programmatic temperature adjustments via the truetemperature endpoint. This CLI tool provides a simple interface to the py-netatmo-truetemp library.

Archival Policy: This repository will be archived or removed if:

• Netatmo officially adds temperature control support to their OAuth API
• Netatmo requests takedown of this project

Use at Your Own Risk: This tool relies on undocumented endpoints that may change without notice. It controls heating equipment - test thoroughly before relying on it in production.

Features

• Accurate Temperature Control: Uses TrueTemperature calibration system for precise setpoints
• Room-by-Room Management: Control individual rooms by name or ID
• Beautiful Terminal Output: Rich formatting with tables and styled panels
• Secure Configuration: Environment variable-based credential management
• Cross-Platform: Works on Linux, macOS, and Windows
• Robust Error Handling: User-friendly error messages with actionable guidance

Installation

pip install py-netatmo-truetemp-cli

Quick Start

1. Set Environment Variables

export NETATMO_USERNAME="[e-mail]"
export NETATMO_PASSWORD="your-password"
export NETATMO_HOME_ID="your-home-id"  # Optional, auto-detected if omitted

2. List Rooms

netatmo-truetemp list-rooms

3. Set Temperature

# By room name (case-insensitive)
netatmo-truetemp set-truetemperature --room-name "Living Room" --temperature 20.5

# By room ID
netatmo-truetemp set-truetemperature --room-id 1234567890 --temperature 20.5

Commands

list-rooms

Lists all rooms with thermostats in your home.

Options:

• --home-id TEXT: Home ID (optional, uses default if not provided)

Example:

netatmo-truetemp list-rooms
netatmo-truetemp list-rooms --home-id <home_id>

set-truetemperature

Sets the calibrated temperature for a Netatmo room.

Options:

• --temperature FLOAT: Temperature value (required)
• --room-id TEXT: Room ID to set temperature for
• --room-name TEXT: Room name to set temperature for (alternative to --room-id)
• --home-id TEXT: Home ID (optional, uses default if not provided)

Examples:

netatmo-truetemp set-truetemperature --room-name "Living Room" --temperature 20.5
netatmo-truetemp set-truetemperature --room-id 1234567890 --temperature 19.0

Common Use Cases

List Available Rooms

netatmo-truetemp list-rooms

Set Room Temperature

# By room name (case-insensitive)
netatmo-truetemp set-truetemperature --room-name "Living Room" --temperature 21.0

# By room ID (for automation scripts)
netatmo-truetemp set-truetemperature --room-id "1234567890abcdef" --temperature 21.0

Automation Example

#!/bin/bash
# Adjust bedroom temperature based on time of day
HOUR=$(date +%H)

if [ $HOUR -ge 22 ]; then
    netatmo-truetemp set-truetemperature --room-name "Bedroom" --temperature 18.0
fi

Configuration

Environment Variables

Variable	Required	Description
NETATMO_USERNAME	Yes	Your Netatmo account email
NETATMO_PASSWORD	Yes	Your Netatmo account password
NETATMO_HOME_ID	No	Home ID (auto-detected if omitted)

Security

Credential Management:

• Store credentials in environment variables (never commit to version control)
• For CI/CD or automation, use your platform's secret management system

Authentication Cache: The underlying library caches authentication tokens at:

• Linux: ~/.local/share/netatmo-truetemp/
• macOS: ~/Library/Application Support/netatmo-truetemp/
• Windows: %LOCALAPPDATA%\netatmo-truetemp\

To report security vulnerabilities, see SECURITY.md.

Development

Setup

git clone https://github.com/py-netatmo-unofficial/py-netatmo-truetemp-cli.git
cd py-netatmo-truetemp-cli
uv venv
uv sync
uv run pre-commit install

Run Tests

uv run pytest

Run Linting

uv run ruff check src/ tests/
uv run ruff format src/ tests/

Run Type Checking

uv run mypy src/

Contributing

Contributions are welcome! Please read our Contributing Guide for details on:

• Code of conduct
• Development setup
• Running tests
• Code style guidelines
• Conventional commit message format (required)
• Submitting pull requests

All commits must follow the Conventional Commits format. Pre-commit hooks will validate your commit messages automatically.

See also:

• Code of Conduct
• Security Policy
• Changelog

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

Having issues or want to contribute?

• Bug Reports: Create an issue
• Feature Requests: Request a feature
• Discussions: Join the conversation
• Contributing: See CONTRIBUTING.md
• Security Issues: See SECURITY.md

Related Projects:

• py-netatmo-truetemp - The underlying Python library
• PyPI Package

Acknowledgments

Built with py-netatmo-truetemp, Typer, and Rich.