1.0.1 • Published 4 months ago

homebridge-intelliclima v1.0.1

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
4 months ago

IntelliClima Homebridge

verified-by-homebridge npm npm GitHub pull requests GitHub issues

Homebridge plugin for WiFi Thermostats manufactured by Fantini Cosmi and connected to IntelliClima. More devices can be added in the future if they are compatible with the IntelliClima API.

Package Requirements

PackageInstallationRoleRequired
HomebridgeHomebridge WikiHomeKit BridgeRequired
Config UI XConfig UI X WikiHomebridge Web User InterfaceRecommended
Homebridge IntelliClimaPlug-In READMEHomebridge Plug-InRequired

About The Plugin

  • All devices are detected automatically through IntelliClima API.
  • Supports one house per account
  • Supports Power ON/OFF.
  • Supports Operating mode POWER OFF/HEAT/COOL/AUTO.
  • Supports Temperature configuration for HEATING.
  • Supports Temperature display units Celsius ºC / Fahrenheit ºF.
  • Support Automations, Shortcuts and Siri.
  • Support to add extra temperature for HomeKit automations.
  • Support to add extra humidity for HomeKit automations.

Configuration

  • Run this plugin as a Child Bridge (Highly Recommended), this prevent crash Homebridge if plugin crashes.
  • Install and use Homebridge Config UI X to configure this plugin (Highly Recommended).
  • Be sure to always make a backup copy of your config.json file before making any changes to it.
KeyDescription
usernameThe plugin needs to access IntelliClima API to interact with the device so it will be using your IntelliClima App credentials to authenticate.
passwordYour password will not be shared, it will be only used it to authenticate with IntelliClima API. It is the same you use in your IntelliClima App
temperatureSensorThis enable extra temperature sensor to use with automations in HomeKit app
humiditySensorThis enables extra humidity sensor to use with automations in HomeKit app

Caveats

Fantini Cosmi do not provide any open/public API to interact with their devices. This plugin uses the same API that the official IntelliClima App uses and there is not documentation on how to interact with it, but just observing how the App behaves. This means that if Fantini Cosmi changes their API, this plugin might stop working.

Currently, this plugin fully supports C800WiFi thermostats as it is the device I own. If you have a different device a huge part of the plugin will probably work, but some features might be broken. If you have a different device and you want to add support for it, please open an issue and I will do my best to add support for it with your support to test the device.

IntelliClima Homebridge is a hobby project of mine, provided as-is, with no warranty whatsoever. I'm running it successfully at home since I created it, but your mileage might vary.