![](\"https://i.imgur.com/w7nyvOl.png\")
\n\n \n
![\"HomeKit](\"https://raw.githubusercontent.com/SeydX/homebridge-instances-platform/master/images/69E0F798-BCB6-4F15-B279-7C44AE311FC6.gif\")
\n\nThis is a dynamic platform plugin for [Homebridge](https://github.com/nfarina/homebridge) to control your **homebridge instance(s)**. It is capable to dynamically add or remove services, depending on if service is enabled or disabled! It is also possible to add a listener to your journalctl. The listener will listen on errors and will send a notification (via telegram) if a service crashes.\n\nThis plugin supports following functions:\n\n**Main Switch:**\n- **Temperature:** Shows current CPU temperature\n- **Uptime:** Shows uptime of the computer\n- **CPU Usage:** Shows summarized CPU usage of all detected services\n- **RAM Usage:** Shows summarized CPU usage of all detected services\n- **Disk Space:** Shows available disk space\n- **Updatable Plugins:** Shows amount of updatable plugins and extra switch to update all plugins\n- ~~**Accessories:** Shows amount of published accessories (only for homebridge instances in insecure mode (-I) and Pin 031-45-154~~ (removed)\n\n**Services:**\n- **Service Power Switch:** Start/Stop Homebridge Instance\n- **Service Status:** Shows current state of the homebridge instance (active/inactive)\n- **Service Uptime:** Shows current uptime of the homebridge instance\n- **Service CPU Usage:** Shows CPU usage of all running services\n- **Service RAM Usage:** Show RAM usage of all running services\n\n## Installation instructions\n\nAfter [Homebridge](https://github.com/nfarina/homebridge) has been installed:\n\n- ```(sudo) npm i -g homebridge-instances-platform@latest```\n\n\n## Basic configuration\n\n ```\n{\n \"bridge\": {\n ...\n},\n \"accessories\": [\n ...\n],\n \"platforms\": [\n {\n \"platform\": \"InstancesPlatform\",\n \"startParam\": \"homebridge\",\n \"clearCache\": false,\n \"sudo\": false,\n \"temperature\": {\n \"active\": true\n },\n \"notifier\":{\n \"active\": true,\n \"token\": \"TELEGRAMTOKEN\",\n \"chatID\": \"TELEGRAMCHATID\",\n \"filter\": [\"Main process exited\", \"Error\", \"error\", \"ERROR\"],\n \"filterInstances\": [\"homebridge-alexa\"],\n \"spamInterval\": 1,\n \"updatesPolling\": 12\n },\n \"exclude\": [\"homebridge-alexa\"]\n }\n ]\n}\n ```\n See [Example Config](https://github.com/SeydX/homebridge-instances-platform/blob/master/example-config.json) for more details.\n\n \n ## Options\n\n| **Attributes** | **Required** | **Usage** |\n|------------|----------|-------|\n| platform | **Yes** | Must be **InstancesPlatform** |\n| startParam | **No** | The word with which all .service files start _(Default: \"homebridge\")_ |\n| clearCache | **No** | If true, the accessory will be removed from HomeKit _(Default: false)_ |\n| sudo | **No** | If you have problems starting/stopping an instance, set this true _(Default: false)_|\n| polling | **No** | Polling interval in seconds _(Default: 5s)_ |\n| temperature.active | **No** | Temperature Characteristic for CPU Temperature _(Default: false)_ |\n| temperature.file | **No** | Custom file path to CPU Temperature (eg for Orange PI) |\n| temperature.multiplier | **No** | Custom multiplier (eg for Orange PI) |\n| notifier.active | **No** | Telegram notification _(Default: false)_ |\n| notifier.token | **No** | Telegram Bot Token |\n| notifier.chatID | **No** | Telegram Chat ID |\n| notifier.filter | **No** | An array/string of matches to filter _(Default: ['Main process exited'])_ |\n| notifier.filterInstances | **No** | An array/string of matches to filter instances _(Default: false)_ |\n| notifier.spamInterval | **No** | Timer in minutes to block telegram spam _(Default: 1 min)_ |\n| notifier.updatesPolling | **No** | Polling interval in hours for check plugin updates _(Default: 12h)_ |\n| exclude | **No** | An array of services to exclude from discovery |\n\n\n## Supported clients\n\nThis plugin has been verified to work with the following apps on iOS 12.2 and iOS 12.3 Beta:\n\n* iOS 12.2 / iOS 12.3 Beta\n* Apple Home _(partial)_\n* All 3rd party apps like Elgato Eve etc. _(recommended)_\n* Homebridge v0.4.48\n* Debian\n\n\n## Contributing\n\nYou can contribute to this homebridge plugin in following ways:\n\n- [Report issues](https://github.com/SeydX/homebridge-instances-platform/issues) and help verify fixes as they are checked in.\n- Review the [source code changes](https://github.com/SeydX/homebridge-instances-platform/pulls).\n- Contribute bug fixes.\n- Contribute changes to extend the capabilities\n\nPull requests are accepted.\n\n\n## Troubleshooting\n\n### Upgrading from v1.4.5 to 1.4.6 or higher\n\nDue to some major bugfixes, you need to remove the Accessory from HomeKit! After update, set \"clearCache\": true in your config.json and restart homebridge. This will remove the accessory from HomeKit and your cache. After this, set \"clearCache\": false in config.json and restart homebridge again. This will add the Accessory (Switch) to HomeKit again\n","readmeFilename":"README.md"}