node-red-contrib-tahoma 1.0.0

Control a Somfy Tahoma box from Node RED

npm install node-red-contrib-tahoma

npm npm license


You can read this guide from Node-RED official portal. This will help you install this node. Typically, the command are as follows:

cd $HOME/.node-red
npm install node-red-contrib-tahoma


This software is provided as-is. Be careful: your devices can be totally controlled via API actions. I am not responsible of any mis-usage or corruption of the devices configuration.


In order to use this node, you need to have a Tahoma Link account. If you already use the Tahoma Box and the mobile apps, you should have one.

When creating your first node, you will be asked to provide your e-mail and password used to login to your Tahoma Link account. These will be used to connect to the API (of course, they will only be used locally, they are not forwarded to me :)).


This node accepts an object as input. The following properties will be parsed:

Property Type Required? Description
action enum (see below) Yes The action to perform
position int (0-100) No The position you want to set your blinds/door to
lowspeed boolean No Should the action be triggered in low-speed mode?


Currently, only a few commands are understood by this node. The possible values for the action property are:

  • open: This will open the device (door, blind...)
  • close: This will close the device
  • stop: This will stop all running actions
  • customPosition: This will set the device to a custom position. The position is passed using the position property, which is required in this mode.


The node will output its original msg.payload enriched with the result of the expected action. msg.payload.output will contain 2 properties:

  • open: a boolean. Set to true if the device is open, or false otherwise
  • position: an integer (0-100). Set to the position returned by the Tahoma box.
  • luminance: in case of a Sun Sensor, returns the current value of core:LuminanceState (See issue #6)

Example flow

Example Flow

An example flow can be found in the docs/ folder. Basically, all it does is close and open shutters based on manual triggers. Those can be replaced by some logic (e.g. a node calculating the sunset and sunrise times). The output is sent to a local MQTT broker.


This was tested with the following devices:

  • IO-HomeControl Roller Shutters
  • IO-HomeControl Garage Door
  • Sunea IO Awning (thanks to @xeor)

Feel free to send any feedback of any other compatible items or known limitations :)


These are the things that should be updated (and will be later) on this module:

  • Filter elements that can actually be controlled (e.g. do not display the "Active Button")
  • Find a way to properly handle "my" position

Node Info

Version: 1.0.0
Updated 2 months, 1 week ago
License: Apache-2.0


1 in the last day
7 in the last week
37 in the last month


  • tahoma
  • tahoma-read
  • tahoma-config


  • node
  • red
  • node-red
  • tahoma
  • somfy
  • home
  • automation


  • nikkow