https://github.com/stfnhmplr/homebridge-homee

use your homee with homebridge
https://github.com/stfnhmplr/homebridge-homee

homebridge homebridge-plugin homee

Last synced: about 2 months ago
JSON representation

use your homee with homebridge

• Host: GitHub
• URL: https://github.com/stfnhmplr/homebridge-homee
• Owner: stfnhmplr
• License: mit
• Created: 2017-07-10T15:01:38.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2024-01-28T18:35:19.000Z (11 months ago)
• Last Synced: 2024-04-14T08:34:45.330Z (9 months ago)
• Topics: homebridge, homebridge-plugin, homee
• Language: JavaScript
• Homepage:
• Size: 195 KB
• Stars: 14
• Watchers: 8
• Forks: 6
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Homebridge-homee

homee platform plugin for homebridge: https://github.com/nfarina/homebridge

## Installation

Follow the instruction in [NPM](https://www.npmjs.com/package/homebridge) for the homebridge server installation. The plugin is published through [NPM](https://www.npmjs.com/package/homebridge-homee) and should be installed "globally" by typing:

    sudo npm install -g homebridge-homee

Alternatively you could use [**homeean**](https://himpler.com/homeean) to install homebridge-homee (including Homebridge) on a Raspberry Pi with a plain vanilla Raspbian installation. homeean is a web based buildtool, which generates an individual buildscript (Bash-Script) for user selected Smart Home Tools to be installed on a Raspberry Pi running on Raspbian. homebridge-homee (including its dependecy Homebridge) is provided as an homeean install option.

## Configuration

config.json

Example:

    {

        "bridge": {

            "name": "Homebridge",

            "username": "CC:22:3D:E3:CE:51",

            "port": 51826,

            "pin": "031-45-154"

        },

        "description": "This is an example configuration file for the homebridge-homee plugin",

        "hint": "Always paste into jsonlint.com validation page before starting your homebridge, saves a lot of frustration",

        "platforms": [

            {

                "platform": "homee",

                "name": "homee",

                "host": "192.168.178.1",

                "user": "your-username",

                "pass": "your-password",

                "groupName": "group-name",

                "alarmGroup": "AlarmGroupName",

                "deviceId": "homebridge"

            }

        ]

    }

If you use multiple instances of this plugin with the same homee, you have to specify a custom deviceId.

## Exclude nodes or homeegrams

This plugin integrates all (known) devices to homebridge by default. You can limit the integration to certain devices by creating a group in homee and adding all the devices you want to use with homebridge. If not explicitly specified, the name of this group defaults to 'Homebridge'. It may be changed using the optional 'groupName' statement. Devices outside this group are ignored.

### Device Limit

Homekit cannot manage more than 100 devices per bridge. If you have together more than 100 devices and homeegrams, you have to filter some of them with a group.

## Security System

You can activate a security system. Just create an alarm group in homee and add it to your config file. Possible triggers are e.g. motion detectors, smoke detectors, leak detectors and so on. You can add as many triggers as you like. In combination with the presence status in homee, the selected sensors can trigger an alarm in HomeKit.

 The manipulation alarm of the sensors is also transmitted to HomeKit.

 Since the presence states cannot be matched one to one with homee, the following mapping is carried out:

 | homee  | Homekit  |

 |---|---|

 | Home | Disarmed |

 | Sleeping | Night Armed |

 | Away | Stay Armed |

 | Holiday | Away Armed |

## Tested devices

- Danfoss Living connect Thermostat

- Devolo Door/Window Sensor

- Devolo Motion Sensor

- Devolo Heizkörperthermostate

- Devolo Smart Metering Plug

- Everspring AN180 Wall Plug

- Fibaro Door/Window Sensor

- Fibaro Double Switch

- Fibaro Flood Sensor

- Fibaro Motion Sensor

- Fibaro Roller Shutter 2 (FGR-222)

- Fibaro Smoke Sensor 2

- Fibaro Wall Plug

- Greenwave Powernode

- Philips Hue White and Color Ambiance

- Philips Hue White

- Popp Rauchwarnmelder mit Sirene

- Qubino Flush Dimmer

- Sensative Stripes

## Donate