This repo bundles some example implementations for homebridge plugins. They provide some example code to get
started with. They are also published on npm like regular plugins, so you can easily run them in your local
homebridge instance. Refer to the respective
package.json for the plugin name and install them as usual.
The examples are all written in Typescript and thus require at least homebridge
To build a plugin run the following commands in the respective plugin directory.
Run this command once to install all dependencies required by the plugin:
npm run build
./dist folder. You may need to ignore some code at the beginning of the file
generated by the Typescript compiler.
Examples for different homebridge plugin types
Accessory plugins are the most basic and simplest plugins for homebridge. They should be used if you only want to expose a single accessory and don't require any special functionality.
- Accessory Plugin: A simple Switch accessory.
Platform plugins are able to expose multiple accessories. Additionally, they are required if you want to use the Controller API.
- Static Platform Plugin: Static platforms know which accessories they want to expose on start up. The set of accessories cannot change over the lifespan of the plugin.
- Dynamic Platform Plugin: Dynamic platforms can dynamically add or remove accessories at runtime. Accessories are fully stored to disk by homebridge, and the exact state is reconstructed on a reboot. The plugin can store additional context as well.
- Independent Platform Plugin: Independent platforms are typically used when the platform intends to only expose external accessories or provides other functionality while not exposing an accessory at all.