homebridge-tahoma-mwl

v0.3.52

Sample Platform plugin for TaHoma and Cozytouch services (Somfy,Atlantic,Thermor,Sauter): https://github.com/dubocr/homebridge-tahoma For more information about how to use this package see README

Latest version published 4 years ago

License: Apache-2.0

NPM

GitHub

Package Health Score

42 / 100

security
Security review needed
popularity
Limited
maintenance
Inactive
community
Sustainable

Explore Similar Packages

Security

Security review needed

All security vulnerabilities belong to production dependencies of direct and indirect packages.

Security and license risk for significant versions

All Versions

Version				Vulnerabilities	License Risk
0.3.52	\|	12/2020	Popular	0 C 0 H 0 M 0 L	0 H 0 M 0 L

License

Apache-2.0

Security Policy

Is your project affected by vulnerabilities?

Scan your projects for vulnerabilities. Fix quickly with automated fixes. Get started with Snyk for free.

Get started free

Popularity

Limited

Weekly Downloads (2)

GitHub Stars: 135
Forks: 42
Contributors: 20

Direct Usage Popularity

The npm package homebridge-tahoma-mwl receives a total of 2 downloads a week. As such, we scored homebridge-tahoma-mwl popularity level to be Limited.

Based on project statistics from the GitHub repository for the npm package homebridge-tahoma-mwl, we found that it has been starred 135 times.

Downloads are calculated as moving averages for a period of the last 12 months, excluding weekends and known missing data points.

Community

Sustainable

Readme.md: Yes
Contributing.md: No
Code of Conduct: No
Contributors: 20
Funding: No

With more than 10 contributors for the homebridge-tahoma-mwl repository, this is possibly a sign for a growing and inviting community.

We found a way for you to contribute to the project! Looks like homebridge-tahoma-mwl is missing a Code of Conduct.

Embed Package Health Score Badge

Maintenance

Inactive

Commit Frequency

Open Issues: 42
Open PR: 4
Last Release: 4 years ago
Last Commit: 2 months ago

Further analysis of the maintenance status of homebridge-tahoma-mwl based on released npm versions cadence, the repository activity, and other data points determined that its maintenance is Inactive.

An important project maintenance signal to consider for homebridge-tahoma-mwl is that it hasn't seen any new versions released to npm in the past 12 months, and could be considered as a discontinued project, or that which receives low attention from its maintainers.

In the past month we didn't find any pull request activity or change in issues status has been detected for the GitHub repository.

Keep your project healthy

Check your package.json

Ensure all the packages you're using are healthy and well-maintained

Snyk Vulnerability Scanner

Get health score & security insights directly in your IDE

Package

Node.js Compatibility: >=0.12.0

Age: 4 years
Dependencies: 4 Direct
Versions: 3
Install Size: 177 kB
Dist-tags: 1
# of Files: 28
Maintainers: 1
TS Typings: No

homebridge-tahoma-mwl has more than a single and default latest tag published for the npm package. This means, there may be other tags available for this package, such as next to indicate future releases, or stable to indicate stable releases.

Readme

homebridge-tahoma

Supports TaHoma (Somfy), Connexoon (Somfy), Cozytouch (Atlantic,Thermor,Sauter) and E.Connect 2 (Rexel) platforms on HomeBridge

Installation

Install homebridge using: npm install -g homebridge
Install this plugin using: npm install -g homebridge-tahoma
Update your configuration file. See bellow for a sample.

Configuration

Minimal configuration sample:

{
	"bridge": {
		...
	},

	"description": "...",

	"accessories": [],

	"platforms":[
		{
			"platform": "Tahoma",
			"name": "My TaHoma Box",

			"user": "user@me.com",
			"password": "MyPassw0rd",
		}
	]
}

Configuration parameters:

Parameter	Type	Default	Note
`user`	String	null	mandatory, your TaHoma/Connexoon/Cozytouch/E.Connect account username
`password`	String	null	mandatory, your TaHoma/Connexoon/Cozytouch/E.Connect account password
`service`	String	'TaHoma'	optional, service name ('TaHoma', 'Connexoon', 'Connexoon RTS', 'Cozytouch' or 'Rexel')
`refreshPeriod`	Integer	1800	optional, device states refresh period in seconds
`pollingPeriod`	Integer	0	optional, bridge polling period in seconds for sensors events (0: no polling)
`exclude`	String[]	[]	optional, list of protocols (hue,enocean,zwave,io,rts), device types (eg. RollerShutter), device definitions (eg. WindowCovering) or device (name) to exclude
`exposeScenarios`	Boolean	false	optional, expose TaHoma/Connexoon/Cozytouch scenarios as HomeKit switches. Could also specify a list of string corresponding to scenarios names to expose
`forceType`	Object	{}	optional, list of device (name) to force with another type (see below). Ex. Fan recognised as Light can be force to Fan type
`Alarm`	Object	{}	optional, Alarm configuration object (see below)
`WindowCovering`	Object	{}	optional, WindowCovering configuration object (see below)
`GarageDoorOpener`	Object	{}	optional, GarageDoorOpener configuration object (see below)

Alarm parameters	Type	Default	Note
`STAY_ARM`	String	'A'	optional, active zones (A,B,C) in 'Stay' mode
`NIGHT_ARM`	String	'B'	optional, active zones (A,B,C) in 'Night' mode
`occupancySensor`	Boolean	false	optional, add an occupancy widget linked to the alarm

WindowCovering parameters	Type	Default	Note
`initPosition`	Integer	50	optional, default position for UpDown rollershutter
`defaultPosition`	Integer	0	optional, final position for UpDown rollershutter after any command
`reverse`	Boolean	false	optional, reverse up/down in case of bad mounting
`blindMode`	String	null	optional, define main slider action (slates orientation or closure). By default, both closure and orientation will be set. When setting `blindMode: "orientation"` the blinds work in the following way: Opening the blinds or setting them to 100% will fully open them. Closing the blinds or setting them to 0% will fully close them. Setting the blinds to a value between 1% and 99% will first close the blinds and then adjust thier horizontal tilt in a way that 99% means fully horizonal = more light, and 1% means nearly closed = less light. When setting `blindMode: "closure"` the blinds work in the following way: Closing the blinds or setting them to 0% will fully close them. Opening the blinds or setting them to 100% will open them with specified orientation.

GarageDoorOpener parameters	Type	Default	Note
`cyclic`	Boolean	false	optional, activate restoring initial state for cyclic device without
`reverse`	Boolean	false	optional, reverse up/down in case of bad mounting
`stateless`	Boolean	false	optional, force stateless device detection (if your device hasn't state reports but don't react as it in HomeKit)

Full configuration example:

{
	"bridge": {
		...
	},

	"description": "...",

	"accessories": [],

	"platforms":[
		{
			"platform": "Tahoma",
			"name": "My Tahoma",

			"user": "user@me.com",
			"password": "MyPassw0rd",
			"service": "TaHoma",
			"exclude": ["hue","rts","Garage Door"],
			"forceType": {"Beedrom Fan": "Fan"}
			"Alarm": {
				"STAY_ARM": "A,C",
				"NIGHT_ARM": "B"
			}
		}
	]
}

Limitation

Some devices or configurations could not operate properly due to limited tests. Don't hesitate to open an issue if your device doesn't work properly. Before opening issue, please submit your config with this form

Contribute

You are welcome to contribute to this plugin development by adding new kind of devices by adding implementation .js file in accessories folder or improving existing 'js' file. These documentations could help you developing plugin : Obtaining my config, HomeKit services and characteristics

I do not expect any reward concerning this plugin, however, some users ask me for a button as sign of contribution. Feel free to use it.

homebridge-tahoma-mwl dependencies

js path polling-to-event request

FAQs

What is homebridge-tahoma-mwl?

Sample Platform plugin for TaHoma and Cozytouch services (Somfy,Atlantic,Thermor,Sauter): https://github.com/dubocr/hom... Visit Snyk Advisor to see a full health score report for homebridge-tahoma-mwl, including popularity, security, maintenance & community analysis.

Is homebridge-tahoma-mwl popular?

The npm package homebridge-tahoma-mwl receives a total of 2 weekly downloads. As such, homebridge-tahoma-mwl popularity was classified as limited. Visit the popularity section on Snyk Advisor to see the full health analysis.

Is homebridge-tahoma-mwl well maintained?

We found indications that homebridge-tahoma-mwl is an Inactive project. See the full package health analysis to learn more about the package maintenance status.

Is homebridge-tahoma-mwl safe to use?

While scanning the latest version of homebridge-tahoma-mwl, we found that a security review is needed. A total of 0 vulnerabilities or license issues were detected. See the full security scan results.

Last updated on 17 November-2024, at 06:08 (UTC).

Build a secure application checklist

Select a recommended open source package

Minimize your risk by selecting secure & well maintained open source packages

DONE

Scan your app for vulnerabilities

Scan your application to find vulnerabilities in your: source code, open source dependencies, containers and configuration files

SCAN NOW

Fix identified vulnerabilities

Easily fix your code by leveraging automatically generated PRs

AUTO FIX

Monitor for new issues

New vulnerabilities are discovered every day. Get notified if your application is affected

MONITOR APP