# homebridge-multi-tap-switch

> A configurable multi-tap switch for i.e. switching scenes

Latest version **0.4.0** (published 2026-02-08) · MIT license · 0 weekly downloads

## Install

```sh
npm install homebridge-multi-tap-switch
pnpm add homebridge-multi-tap-switch
yarn add homebridge-multi-tap-switch
bun add homebridge-multi-tap-switch
```

## Health

**Score 55/100 (C)** — status: stable.

Positive: has types; no vulnerabilities; has provenance.

Warnings: low downloads; no esm support; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.4.0 |
| Published | 2026-02-08 |
| First published | 2023-02-04 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | ^20.18.0 \|\| ^22.10.0 \|\| ^24.0.0 |
| Dependencies | 1 |
| Unpacked size | 55.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 1 |
| Author | Dennis Twardowsky |
| Maintainers | dtwardow |
| Keywords | homebridge-plugin |

## Links

- npm: https://www.npmjs.com/package/homebridge-multi-tap-switch
- Repository: https://github.com/dtwardow/homebridge-multi-tap-switch
- Homepage: https://github.com/dtwardow/homebridge-multi-tap-switch#readme
- Issues: https://github.com/dtwardow/homebridge-multi-tap-switch/issues
- npm.io page: https://npm.io/package/homebridge-multi-tap-switch

## Dependencies (1)

- [homebridge-lib](https://npm.io/package/homebridge-lib.md) ^7.1.12

## Alternatives

- [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads
- [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads
- [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads
- [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads
- [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads

## Recent versions

- 0.4.0 (latest) — 2026-02-08
- 0.3.0 — 2023-02-24
- 0.2.0 — 2023-02-05
- 0.1.6 — 2023-02-04
- 0.1.5 — 2023-02-04
- 0.1.4 — 2023-02-04
- 0.1.2 — 2023-02-04
- 0.1.1 — 2023-02-04
- 0.1.0 — 2023-02-04

## README

<p>
<img src="https://github.com/homebridge/branding/blob/latest/logos/homebridge-color-round-stylized.png" width="150" alt="Homebridge">
</p>

# Homebridge Multi-Tap-Switch

This plugin provides a switch, which can be triggered multiple times to trigger different actions.

Actions could be everything, which can be configured within **Automations**.

## How it works?

The plugin provides a virtual **switch** which can be triggered manually (which doesn't really make sense) or
by **Automations**. A configurable set of **programmable** switches will than be used to
trigger scenes and/or devices (like for i.e. motion or contact sensors).

Each time the switch is triggered ```ON``` - what can be done multiple times without reset - the **stateless** switches
are triggered one after the other.
The switch is reset after a configurable timeout to start from the first **programmable** switch again. 

## Installation

Either install this plugin through [Homebridge Config UI X](https://github.com/oznu/homebridge-config-ui-x)
or manually by following these instructions:

1. Install Homebridge (follow [the instructions](https://github.com/homebridge/homebridge/wiki)).
2. Install this plugin by running `npm install -g homebridge-multitap-switch`.
3. Add this plugin to the Homebridge `config.json` (as described in the next section)

## Configuration

The configuration allows the user to add multiple **Multi-Tap-Switches**. The following parameters are available:

| Option                              | Default Value  | Characteristic (runtime configuration) | Description                                                                               |
|-------------------------------------|----------------|----------------------------------------|-------------------------------------------------------------------------------------------|
| `name`                              | MultiTapSwitch |                                        | Name of the Platform Accessory (primarily shown in logs)                                  |
| `devices[]`                         |                |                                        | Array of configured devices                                                               |
| `devices[].name`                    |                |                                        | Name of the switch                                                                        |
| `devices[] .numberConfiguredScenes` | 5              | `Configured Scenes`                    | Number of **stateless** switches (cannot be changed during runtime)                       |
| `devices[] .triggerTimeout`         | 10             | `Trigger Timeout`                      | Seconds, after which the switch is reset (starting from the first **programmable** switch |
| `devices[] .resetAfterSwitchOff`    | false          |                                        | Reset the switch (like after timeout), when it is turned ```OFF```.                       |
| `devices[] .logging`                | false          |                                        | Logging of switch/trigger actions.                                                        |

The parameter ```triggerTimeout``` can be changed in the configuration during runtime. So, this is just the initial value.

The parameter ```numberConfiguredScenes``` just defines how many **programmable** switches are available (currently, there is no limit). The number of
really **used** switches can configured during runtime, between 0 and the configured number.

> **NOTE:** Additional parameters (also called **Characteristics**) can only be configured via 3rd-party HomeKit apps, but not in the basic Home App!

So, an example **platform** plugin config will look as follows:

````
    {
      "platform": "MultiTapSwitch",
      "name": "MTSwitch",
      "devices": [
        {
          "name": "MTSwitch 1",
          "numberConfiguredScenes": 5,
          "triggerTimeout": 10,
          "resetAfterSwitchOff": true,
          "logging": true
        }
      ]
    }
````

## Contribution

Contributions are always welcome. You can also use the code for own projects and adapt it to your specific needs.

If you find any bugs or have ideas for optimizations or new features, feel free.

---
_Source: https://npm.io/package/homebridge-multi-tap-switch · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._