Naughty Pinching Mannequins
Miss any of our Open RFC calls?Watch the recordings here! »


0.1.231 • Public • Published


Donate some coins if you want Build Status Greenkeeper badge JavaScript Style Guide

Supports the Homematic System on HomeBridge Platform

Devices currently supported:

Switches , Dimmer , RotaryHandles, WindowContacts, MotionSensor, Blinds, Keymatic ProgramStarter, SmokeDetector, Thermostats ....


  1. Make sure that you use a node version >= 4.5
  2. Install homebridge using: npm install -g homebridge
  3. Install this plugin using: npm install -g homebridge-homematic
  4. Update your configuration file. See the sample below.


Configuration sample:

"platforms": [
           "platform": "HomeMatic",
           "name": "HomeMatic CCU",
           "ccu_ip": "",

Configuration Changes Version > 214

Beginning of Version 0.0.214 other that the above configuration settings has been moved to a plugin own config file. So you are able to use the plugin settings in for the initial configuration.

The file is located at the same path as your config.json and named homematic_config.json

The plugin will copy your settings once to this file

    "filter_channel":["BidCos-RF.KEQXXXXXXX:4", "BidCos-RF.LEQXXXXXXX:2"],
    "outlets":[ "BidCos-RF.KEQXXXXXXX:4","BidCos-RF.IEQXXXXXXX:1"],

Please use the homematic_config.json to setup new stuff.

**** BEGINNING OF VERSION 0.0.41 the selection of channels to use with HomeKit via a CCU Subsection is mandatory *****

Preselect all the Channels you want to import into Homekit by one Subsection at your CCU. Create a new Subsection (in the Sample named as Homekit) and put all the Channels in you want to import. Finally put the name of the subsection into your config.js

Ports: the plugin will use local Port 9090 to communicate with the ccu rfd daemon. Port 9091 for wired and 9092 for hmip (if they are in use). If these ports are in use by other applications, you can change them by the following key in your homematic_config.json


In this case , please make sure that 8081 and 8082 are also available. You got the point ....


You may add binaray variables to Homekit by adding them into your homematic_config.json. They will show up as switches.



If you want to launch Homematic Programs you can also add them to homematic_config.json. There is a issue with ios10. The build in Home App doesnt handle custom Services so you have to add the ios10 flag in your homematic_config.json


Doors and Windows

Homematic Shutter Contacts will be mapped as Contacts into HomeKit by default. If you want to ask Siri about open Windows, you have to add them to a windows config switch:

So they will be mapped into an motorized Window Device. If you add the channel to the doors configuration switch, this channel will be mapped as automated door.



Please only add the channel with number 2 to HomeKit.


The following HMIP Devices should work:

  • HMIP-PSM (Switch - Part)
  • HmIP-SMI
  • HmIP-WTH-2
  • HmIP-STH
  • HmIP-FSM
  • HmIP-BSM
  • HmIP-BDT
  • HmIP-SWO-B

Please setup HMIP by adding the following key to your homematic_config.json



Find further information here.


If the Home app on your iOS device cannot connect to the Homebridge after entering the PIN (and just tells you "there was a problem"), this may be caused by too many devices being presented by the bridge. In this case, try to filter some unused devices, e.g. like this if you don't use the "virtual keys":


Custom Serviceclasses

You own a device that is not currently working with the default implementation here? No problem. You can create custom service classes. With a little bit of knowledge from the existing classes in the ChannelServices folder, this should not be a big deal. Copy the HomeMaticHomeKitDummyService and create your own Serviceclass.

All definitions for the existing classes are located in ChannelServices/channel_config.json. There is a key for each Homematic channeltype and the corresponding name of the service class as value. Be Aware: your personal changes in that file will be overridden by the next update. So you have to set them up in your config.json:

As a sample: the device with the channel WEATHER of the device with type HM-WDS10-TH-O will use the service HomeMaticHomeKitCuxDThermostatService

"services": [
    { "type": "HM-WDS10-TH-O:WEATHER",
          "service": "HomeMaticHomeKitCuxDThermostatService"

or you could use for example the device HmIP-STH just as a regular Temperature and Humidity sensor:

"services": [
    "service": "HomeMaticHomeKitThermostatWeatherServiceIP" }


npm i homebridge-homematic

DownloadsWeekly Downloads






Unpacked Size

350 kB

Total Files


Last publish


  • avatar