README.md

Homebridge Telldus tdtool

A Homebridge plugin for TellStick without Telldus Live, interfaced with the CLI tool tdtool. This will therefore require tdtool to be present, and runnable, on your server running Homebridge.

tdtool can be found as a part of telldus-core, provided by Telldus.

Since it relies on telldus-core, only TellStick Duo and TellStick are supported. TellStick net will support telldus-core, eventually.

Installation

Install this plugin globally by typing the following.

$ npm install -g homebridge-telldus-tdtool

Installing the package globally is not a requirement, but makes it easier if you have also installed Homebridge globally. Otherwise, just install this package in the directory which you have set up Homebridge to watch for plugins in.

You must then include

{
  "platform" : "Telldus-TD-Tool",
  "name" : "Telldus-TD-Tool"
}

in your list of platforms, in the configuration file of Homebridge. This by default resides in ~/.homebridge/config.json and should look something like the following when you have added this platform:

{
  "bridge": {
    "name": "Homebridge",
    "username": "CC:22:3D:E3:CE:30",
    "port": 51826,
    "pin": "031-45-154"
  },
  "platforms": [{
    "platform" : "Telldus-TD-Tool",
    "name" : "Telldus-TD-Tool"
  }]
}

Dependencies & Trade-offs

This plugin depends on tellstick-confparser. This is because tdtool does not output the model of a connected device, making it not possible to provide a devices characteristics for Homebridge unless we peek in TellSticks configuration file and check the model there.

Contribute

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request!