homebridge-tradfri-plugin
Ikea Tradfri Gateway plugin for Homebridge.
Supported features:
- automatically discover your lights and list them
- turn on and off the lightbulbs
- adjust brightness
- adjust color temperature (far from perfect, better solutions than estimating the temperature from hue/saturation are welcome!)
- NEW: color temperature can be adjusted gradually, not just the 3 predefined values.
- NEW: support for outlets
Dependencies
The plugin talks to your gateway through COAP protocol, so you'll need to compile libcoap yourself in order to get going. Instructions for macOS (you need homebrew or some other package manager installed):
brew install libtool
git clone --recursive https://github.com/obgm/libcoap.git
cd libcoap
git checkout dtls
git submodule update --init --recursive
./autogen.sh
./configure --disable-documentation --disable-shared
make
sudo make install
Installation
- Install homebridge using:
npm install -g homebridge - Install this plugin using:
npm install -g homebridge-tradfri-plugin - Update your configuration file. See the sample below.
Configuration
You just need to add the platform to your config.json as shown below:
"platforms": [
...
{
"platform": "IkeaTradfri",
"name": "Tradfri",
"host": "192.168.x.x",
"key": "PSK",
"ignoreBulbs": false // set to true to hide bulbs
}
],
Of course, you will need to add the IP address of the Ikea gateway and the key, which is printed on the bottom of it.
Contributing
The source can be found in the src/ folder. The project is using rollup to bundle the source files. You just need to run npm run build to get it bundled. Don't forget to install the devDependencies too!
Todo
- improve color temperature conversion
- tests
Credit
Thanks to everyone discussing this in this issue: bwssytems/ha-bridge#570
Also, special thanks to stenehall for his project, homebridge-ikea which got me starting.