Tado Assist - Home Assistant Integration

🚀 Introduction

This integration for Home Assistant allows you to use Tado's API to create your own "Auto-Assist." It periodically communicates with Tado's servers to retrieve the home's status and can modify it based on user input. The integration relies on the PyTado library, which is automatically installed alongside it.

ATTENTION: Tado recently limited the number of daily API requests to 20,000 for subscription users and only 100 for non-subscribers.

✨ Features

• Automation: Automates the change of operating mode (Home or Away) and the suspension of home heating.
• Mobile Device Tracking: Detect mobile devices linked to Tado and their home presence.
• Home & Away Modes: Get your home to "Away" or "Home" mode with ease.
• Open Window Detection: Get alerts when a window is detected as open.
• Customizable Scan Interval: Choose how frequently the system checks for updates.
• HA repair: Support repair function in case of re-authentication.
• Data Logging & Debugging: Includes logging support for easy debugging.

🖼 Screenshots

Below are some preview images showcasing Tado Assist in action:

🛠 Installation

1️⃣ Install via HACS (Recommended)

1. Open Home Assistant and install HACS.
2. Go to HACS → Integrations → Add Custom Repository.
3. Enter the repository URL: https://github.com/yourusername/tado-assist.
4. Click Install and restart Home Assistant.
5. Navigate to Settings → Devices & Services → Add Integration → Search for Tado Assist.
6. Enter your Tado credentials and configure the scan interval.

2️⃣ Manual Installation

1. Download the latest release from GitHub Releases.
2. Extract the tado_assist folder into config/custom_components/ in your Home Assistant directory.
3. Restart Home Assistant.
4. Add the integration via Settings → Devices & Services.

📚 Documentation

Short description of the switch:

• Enable Assistant: Enable automatic control of Tado servers via API.
• Geolocation: Check in the Tado servers whether the mode is set to Home or Away and if necessary update the sensor with the correct value (only if Enable Assistant is enabled).
• Window Control: Check Tado servers for zones with open windows and update the sensor with the correct value if necessary (only if Enable Assistant is enabled).
• Away: If enabled, it sets the TADO servers to Away mode, otherwise to Home mode. NOTE: This does not require Enable Assistant to be enabled. If Enable Assistant is not enabled, it only makes one call per status change (limiting the number of calls to a minimum). If Enable Assistant is enabled, it is updated periodically..

🤝 Contributing

We welcome contributions! Feel free to open issues, suggest features, or submit pull requests.

• Feature Requests: Open an issue describing your idea.
• Bug Reports: Report bugs with clear steps to reproduce them.
• Code Contributions: Fork the repo, create a new branch, and submit a pull request.
• Translations: Translate the integration into your language.

☕ Support & Donations

If you find Tado Assist useful, consider buying me a coffee to support future development!

📜 License

This project is licensed under the MIT License.

📌 Changelog

Stay up to date with the latest changes and improvements:

v1.2.0

• Rewritten authentication procedure;
• Added new switch to manually change HOME and AWAY status;
• Bugs fix;

v1.1.0

• New authentication system for TADO servers;
• Support for HA repair function;

v1.0.0 - Initial Release

• First public version.

---

📢 Stay updated! Follow the project on GitHub for updates and new features.