Skip to content

szokeptr/homebridge-tradfri-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

homebridge-tradfri-plugin

npm version

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

Brightness and Color

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

  1. Install homebridge using: npm install -g homebridge
  2. Install this plugin using: npm install -g homebridge-tradfri-plugin
  3. 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.

Releases

No releases published

Packages

No packages published