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.

✨ 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.

🤝 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.1.0 - Initial Release

• 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.