{"id":15051190,"url":"https://github.com/seydx/homebridge-instances-platform","last_synced_at":"2025-08-24T10:14:14.207Z","repository":{"id":57265497,"uuid":"181397329","full_name":"seydx/homebridge-instances-platform","owner":"seydx","description":"Dynamic platform plugin for homebridge instances","archived":false,"fork":false,"pushed_at":"2019-04-30T22:38:16.000Z","size":5727,"stargazers_count":8,"open_issues_count":3,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-24T04:11:26.778Z","etag":null,"topics":["debian","dynamic","homebridge","homebridge-plugin"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seydx.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-04-15T02:20:05.000Z","updated_at":"2025-02-01T21:06:32.000Z","dependencies_parsed_at":"2022-08-25T03:40:43.668Z","dependency_job_id":null,"html_url":"https://github.com/seydx/homebridge-instances-platform","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seydx%2Fhomebridge-instances-platform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seydx%2Fhomebridge-instances-platform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seydx%2Fhomebridge-instances-platform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seydx%2Fhomebridge-instances-platform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seydx","download_url":"https://codeload.github.com/seydx/homebridge-instances-platform/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248144915,"owners_count":21055008,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["debian","dynamic","homebridge","homebridge-plugin"],"created_at":"2024-09-24T21:31:33.604Z","updated_at":"2025-04-10T02:41:17.183Z","avatar_url":"https://github.com/seydx.png","language":"JavaScript","funding_links":["https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=NP4T3KASWQLD8"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://i.imgur.com/w7nyvOl.png\" height=\"200\"\u003e\n\u003c/p\u003e\n\n\n# Instances!Platform v1.4\n\n[![npm](https://img.shields.io/npm/v/homebridge-instances-platform.svg?style=flat-square)](https://www.npmjs.com/package/homebridge-instances-platform)\n[![npm](https://img.shields.io/npm/dt/homebridge-instances-platform.svg?style=flat-square)](https://www.npmjs.com/package/homebridge-instances-platform)\n[![GitHub last commit](https://img.shields.io/github/last-commit/SeydX/homebridge-instances-platform.svg?style=flat-square)](https://github.com/SeydX/homebridge-instances-platform)\n[![Donate](https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square\u0026maxAge=2592000)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=NP4T3KASWQLD8)\n\n**Creating and maintaining Homebridge plugins consume a lot of time and effort, if you would like to share your appreciation, feel free to \"Star\" or donate.**\n\n\u003cimg src=\"https://raw.githubusercontent.com/SeydX/homebridge-instances-platform/master/images/69E0F798-BCB6-4F15-B279-7C44AE311FC6.gif\" align=\"right\" alt=\"HomeKit Overview\" width=\"270px\" height=\"541px\"\u003e\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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseydx%2Fhomebridge-instances-platform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseydx%2Fhomebridge-instances-platform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseydx%2Fhomebridge-instances-platform/lists"}