Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/luligu/matterbridge-somfy-tahoma
Matterbridge somfy tahoma plugin
https://github.com/luligu/matterbridge-somfy-tahoma
alexa apple bridge google-home hap home iot matter matterbridge matterprotocol screens smartthings somfy tahoma
Last synced: 23 days ago
JSON representation
Matterbridge somfy tahoma plugin
- Host: GitHub
- URL: https://github.com/luligu/matterbridge-somfy-tahoma
- Owner: Luligu
- License: apache-2.0
- Created: 2024-03-09T21:35:18.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-11-21T14:41:31.000Z (about 1 month ago)
- Last Synced: 2024-11-29T07:44:36.492Z (23 days ago)
- Topics: alexa, apple, bridge, google-home, hap, home, iot, matter, matterbridge, matterprotocol, screens, smartthings, somfy, tahoma
- Language: TypeScript
- Homepage: https://github.com/Luligu/matterbridge-somfy-tahoma
- Size: 337 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
# Matterbridge somfy tahoma plugin
[![npm version](https://img.shields.io/npm/v/matterbridge-somfy-tahoma.svg)](https://www.npmjs.com/package/matterbridge-somfy-tahoma)
[![npm downloads](https://img.shields.io/npm/dt/matterbridge-somfy-tahoma.svg)](https://www.npmjs.com/package/matterbridge-somfy-tahoma)
[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge?label=docker%20version&sort=semver)](https://hub.docker.com/r/luligu/matterbridge)
[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge.svg)](https://hub.docker.com/r/luligu/matterbridge)
![Node.js CI](https://github.com/Luligu/matterbridge-somfy-tahoma/actions/workflows/build-matterbridge-plugin.yml/badge.svg)[![power by](https://img.shields.io/badge/powered%20by-matterbridge-blue)](https://www.npmjs.com/package/matterbridge)
[![power by](https://img.shields.io/badge/powered%20by-matter--history-blue)](https://www.npmjs.com/package/matter-history)
[![power by](https://img.shields.io/badge/powered%20by-node--ansi--logger-blue)](https://www.npmjs.com/package/node-ansi-logger)
[![power by](https://img.shields.io/badge/powered%20by-node--persist--manager-blue)](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).
## 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
```on Linux (you need the necessary permissions):
```
sudo npm install -g matterbridge
```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
On windows:
```
cd $HOME\Matterbridge
npm install -g matterbridge-somfy-tahoma
matterbridge -add matterbridge-somfy-tahoma
```On linux:
```
cd ~/Matterbridge
sudo npm install -g matterbridge-somfy-tahoma
matterbridge -add matterbridge-somfy-tahoma
```Then start Matterbridge
```
matterbridge -bridge
```## 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": "",
"password": "",
"service": "somfy_europe",
"blackList": [],
"whiteList": [],
"duration": {
"": 30,
"": 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%
```