matterbridge-somfy-tahoma
Version:
Matterbridge somfy tahoma plugin
128 lines (87 loc) • 4 kB
Markdown
# <img src="matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px"> Matterbridge somfy tahoma plugin
[](https://www.npmjs.com/package/matterbridge-somfy-tahoma)
[](https://www.npmjs.com/package/matterbridge-somfy-tahoma)
[](https://hub.docker.com/r/luligu/matterbridge)
[](https://hub.docker.com/r/luligu/matterbridge)
[](https://www.npmjs.com/package/matterbridge)
[](https://www.npmjs.com/package/matter-history)
[](https://www.npmjs.com/package/node-ansi-logger)
[](https://www.npmjs.com/package/node-persist-manager)
---
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](https://github.com/Luligu/matterbridge/blob/main/README.md) 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%
```