miditkl/cremalink-ha
Use your coffee machine with home assistant
cremalink for Home Assistant
The official Home Assistant integration for monitoring and controlling IoT coffee machines via Cremalink.
✨ Overview
This integration connects your Home Assistant instance to the Cremalink ecosystem, allowing for real-time state monitoring and control of smart coffee machines. It is designed to work in tandem with the Cremalink Server Add-on.
Note
This project was developed with a result-oriented approach, primarily optimized for the De'Longhi PrimaDonna Soul. While the architecture is designed to be extensible, some logic may currently be tightly coupled to this specific model.
The goal is to make the library fully generic. If you encounter issues with other machines, contributions are highly encouraged!
Note
cremalink-ha acts solely as a bridge to Home Assistant. Device management (e.g., adding new machines) is handled exclusively via the main cremalink project. Please set up your devices there before using this integration.
🚀 Installation
1. Install the Add-on (Required only for local connection)
Before installing this integration, you must install and configure the Cremalink Server Add-on. This add-on acts as the bridge between your coffee machine and Home Assistant.
👉 Go to Add-on Documentation for setup instructions.
2. Install the Integration
Via HACS (Recommended):
- Click the "Open your Home Assistant instance" badge above, or manually add this repository to HACS as a custom repository.
- Search for "Cremalink" and install.
- Restart Home Assistant.
Manual Installation:
- Copy the
custom_components/cremalink_hafolder to yourconfig/custom_components/directory. - Restart Home Assistant.
⚙️ Configuration
- Navigate to Settings > Devices & Services.
- Click Add Integration.
- Search for Cremalink.
- Follow the configuration flow. You will need to provide the connection details for the Cremalink Server Add-on.
🤝 Contributing
Contributions are welcome! If you have a machine profile not yet supported, please check the Project Wiki of the official cremalink repository on how to add new definitions.
💫 Star History
📄 License
Distributed under the AGPL-3.0-or-later License. See LICENSE for more information.
Developed by Midian Tekle Elfu. Supported by the community.