Liebherr

Liebherr SmartDevice for Homey =============================== Control your Liebherr SmartDevice-enabled refrigerators, freezers, and wine cabinets directly from your Homey smart home hub. FEATURES -------- Every control the Liebherr SmartDevice HomeAPI exposes is supported, mapped automatically per device: - Temperature Control - Per-zone targets for any number of zones (top/middle/ bottom), with the real min/max range and unit reported by each appliance - Night Mode - Interior light (independent of other modes) - Party Mode - Optimize for frequent door openings - SuperCool / SuperFrost - Rapid cool / quick freeze (zone-aware) - Presentation Light - Wine-cabinet interior light, as a dimmer - HydroBreeze - Humidity ventilation mode (Off/Low/Medium/High) - BioFresh-Plus - BioFresh zone mode - IceMaker - Off / On / Max Ice - AutoDoor - Automatic door open/close and state - Dynamic Detection - Discovers each model's actual controls at pairing; no hardcoded device lists, new appliances work automatically - Real-time Monitoring - Polls and reflects current state - Flow Integration - Homey flow cards for automations Note: modes are independent at the API level (e.g. Party and SuperCool can be active together) - the HomeAPI does not enforce mutual exclusivity. SUPPORTED DEVICES ----------------- Works with ALL Liebherr SmartDevice-enabled appliances. The API reports a deviceType used for zone labelling: - Refrigerators (FRIDGE) - Freezers (FREEZER) - Combined Fridge-Freezers (COMBI) - Wine Cabinets (WINE) HOW IT WORKS ------------ The app connects to your Liebherr appliances through the official Liebherr SmartDevice HomeAPI. It uses the same backend as the MyLiebherr mobile app, ensuring reliable and secure control of your devices. Dynamic Capability Detection: The app automatically detects what features your specific Liebherr model supports. When you add a device, it queries the API to discover all available controls (temperature zones, special modes, etc.) and creates the appropriate controls in Homey. This means: - No hardcoded device lists - any SmartDevice appliance works - Future-proof - new features are automatically supported - Model-specific controls - only see what your device can actually do SETUP INSTRUCTIONS ------------------ Prerequisites: 1. A Liebherr appliance with SmartDevice capability 2. MyLiebherr account (same as used in the MyLiebherr mobile app) 3. Developer API key from Liebherr Getting Your API Key: 1. Go to the Liebherr Developer Portal (https://developer.liebherr.com) 2. Sign in with your MyLiebherr account credentials 3. Navigate to APIs -> SmartDevice HomeAPI 4. Click on "Get API Key" or "Show API Key" 5. Copy the API key (40+ character string) Adding Your Device: 1. Install the Liebherr app on your Homey 2. Go to Devices -> Add Device -> Liebherr 3. Select "Liebherr Fridge/Freezer" 4. Paste your API key when prompted 5. Select your device from the list 6. Your device is now ready to use! DEVICE SETTINGS --------------- After adding your device, you can configure: - Update Interval: How often to check device status (60-3600 seconds, default: 300) - Fridge Alarm Temperature: Trigger alarm when fridge exceeds this (5-15°C, default: 10°C) - Freezer Alarm Temperature: Trigger alarm when freezer exceeds this (-10 to -20°C, default: -15°C) Access settings: Devices -> Your Liebherr Device -> Settings (gear icon) FLOW CARDS ---------- Triggers: - Temperature Changed - When fridge/freezer temperature changes - Alarm Triggered - When device triggers an alarm (door open, temperature too high, etc.) * Alarm types: temperature_high, door_open * Provides detailed message with actual values and thresholds Actions: - Toggle Night Mode - Turn night mode (interior light) on/off - Toggle Party Mode - Turn party mode on/off - Toggle SuperCool - Turn SuperCool on/off - Activate SuperCool - Enable rapid cooling for specified duration (1-360 minutes) EXAMPLE FLOWS ------------- - Party Automation: When it's Friday evening -> Toggle Party Mode on - Night Mode: At 10 PM -> Toggle Night Mode on (turns off interior light) - Morning Light: At 7 AM -> Toggle Night Mode off (turns on interior light) - Temperature Alert: When temperature alarm triggers -> Send push notification - High Temperature: When fridge temp > 10°C -> Flash lights red + Send alert - Freezer Warning: When freezer temp > -15°C -> Send urgent notification - Quick Cool: When arriving home with groceries -> Activate SuperCool for 60 minutes - Door Alert: When door open alarm -> Flash lights red - All Clear: When temperature alarm clears -> Send "Temperature normal" message TECHNICAL DETAILS ----------------- API Integration: - Uses official Liebherr SmartDevice HomeAPI - Secure authentication via API key - Real-time device status updates - Automatic error recovery and retry logic Architecture: - Single universal driver for all device types - Dynamic capability mapping - Efficient caching to minimize API calls - Configurable polling intervals (default: 5 minutes) PRIVACY & SECURITY ------------------ - Your API key is stored locally on your Homey - Direct communication with Liebherr servers (no third-party services) - No data is collected or transmitted by this app - Same security as official MyLiebherr app TROUBLESHOOTING --------------- Device Shows as "Unavailable": - Check your internet connection - Verify API key is correct - Ensure device is connected to MyLiebherr app Temperature Control Not Working: - Some models have fixed temperature ranges - Check min/max values for your device - Ensure device is not in special mode that locks temperature Missing Features: - The app only shows features your device supports - Check MyLiebherr app to confirm feature availability - Some features may require firmware updates CONTRIBUTING ------------ This is a community-developed app. Contributions are welcome! Development Setup: npm install --global homey homey app run ACKNOWLEDGMENTS --------------- Special thanks to: - bhuebschen (https://github.com/bhuebschen) for the liebherr Python project which provided invaluable insights into the Liebherr API structure and authentication methods - Liebherr for providing the SmartDevice API documentation - Athom for the excellent Homey platform and SDK - Homey Community for testing and feedback Resources Used: - bhuebschen/liebherr (https://github.com/bhuebschen/liebherr/) - Python implementation that helped understand the API - Liebherr SmartDevice API Documentation (https://developer.liebherr.com) - Homey Apps SDK v3 (https://apps.developer.homey.app) - Node.js https module for API communication SUPPORT ------- For issues, feature requests, or questions: - Create an issue on GitHub - Contact through Homey Community Forum LICENSE ------- This app is provided as-is for personal use. Not affiliated with Liebherr-International AG. --- Note: This is an unofficial community app. Liebherr and MyLiebherr are trademarks of Liebherr-International AG.