README.md

   Matterbridge somfy tahoma plugin

---

This plugin allows to expose to matter the Somfy TaHoma screens.

It exposes also the stateless screens that don't show up in the TaHoma HomeKit bridge because they don't have a bidirectional radio. The plugin resolve the problem counting the time of the screen movement (see Usage section).

If you like this project and find it useful, please consider giving it a star on GitHub at https://github.com/Luligu/matterbridge-somfy-tahoma and sponsoring it.

Prerequisites

Matterbridge

Follow these steps to install or update Matterbridge if it is not already installed and up to date:

on Windows:

npm install -g matterbridge --omit=dev

on Linux (if may need the necessary permissions):

sudo npm install -g matterbridge --omit=dev

See the complete guidelines on Matterbridge for more information.

TaHoma bridge

A working setup of any of the TaHoma bridges (like the Connectivity kit).

How to install

Open the frontend of matterbridge, select the plugin and install it.

How to install from the command line

On windows:

cd $HOME\Matterbridge
npm install -g matterbridge-somfy-tahoma --omit=dev
matterbridge -add matterbridge-somfy-tahoma

On linux:

cd ~/Matterbridge
sudo npm install -g matterbridge-somfy-tahoma --omit=dev
matterbridge -add matterbridge-somfy-tahoma

Then start Matterbridge

matterbridge

How to use it

You need to configure the service ("somfy_europe", "somfy_australia" or "somfy_north_america"), username and password of your Tahoma account.

If the whiteList is defined only the devices included are exposed to Matter.

If the blackList is defined the devices included will not be exposed to Matter.

If any device creates issues put it in the blackList.

Set for each device the full movement time (the plugin will use that time to syncronize the movement).

These are the config values:

{
  "name": "matterbridge-somfy-tahoma",
  "type": "DynamicPlatform",
  "username": "<USERNAME>",
  "password": "<PASSWORD>",
  "service": "somfy_europe",
  "blackList": [],
  "whiteList": [],
  "duration": {
    "<DEVICENAME1>": 30,
    "<DEVICENAME2>": 30
  }
}

You can edit the config file from the frontend (best option) or

On windows:

cd $HOME\.matterbridge
notepad matterbridge-somfy-tahoma.config.json

On linux:

cd ~/.matterbridge
nano matterbridge-somfy-tahoma.config.json

• You can then ask Siri

Siri open the Living room blind
Siri close the Living room blind
Siri set the Living room blind to 70%