{"id":15140421,"url":"https://github.com/bostrt/homebridge-bali-blinds","last_synced_at":"2025-10-23T17:31:15.617Z","repository":{"id":150423307,"uuid":"617636008","full_name":"bostrt/homebridge-bali-blinds","owner":"bostrt","description":"Bali Motorized Blinds Plugin for Homebridge","archived":false,"fork":false,"pushed_at":"2024-01-05T18:02:51.000Z","size":687,"stargazers_count":2,"open_issues_count":3,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-04-24T12:07:53.916Z","etag":null,"topics":["blinds","ezlo","homebridge","homebridge-bali-blinds","homebridge-plugin","mios"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bostrt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-22T19:49:12.000Z","updated_at":"2024-06-01T05:36:08.849Z","dependencies_parsed_at":"2023-12-15T02:00:12.029Z","dependency_job_id":"b2cb6597-ec4a-4eb1-bfd3-f991276190f6","html_url":"https://github.com/bostrt/homebridge-bali-blinds","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":"homebridge/homebridge-plugin-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bostrt%2Fhomebridge-bali-blinds","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bostrt%2Fhomebridge-bali-blinds/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bostrt%2Fhomebridge-bali-blinds/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bostrt%2Fhomebridge-bali-blinds/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bostrt","download_url":"https://codeload.github.com/bostrt/homebridge-bali-blinds/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219868417,"owners_count":16555722,"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":["blinds","ezlo","homebridge","homebridge-bali-blinds","homebridge-plugin","mios"],"created_at":"2024-09-26T08:20:44.539Z","updated_at":"2025-10-23T17:31:10.191Z","avatar_url":"https://github.com/bostrt.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003cimg src=\"./homebridge-bali-blinds.png\" height=\"150\"\u003e\n\n# Homebridge Plugin for Bali Blinds \n\nThis is a [Homebridge](https://homebridge.io/) plugin for [Bali Blinds](https://www.baliblinds.com/motorization/). The Bali Motorization mobile application used to control the blinds only supports Amazon Alex and Google Assistant (as of 2023) hence this plugin's existence.\n\n(Thanks [@hjdhjd](https://github.com/hjdhjd/homebridge-blinds-cmd), I copied some of your Install and Configuration section :smile:)\n\n# Installation\n\nIf you have installed the [Homebridge Config UI](https://github.com/oznu/homebridge-config-ui-x), you can intall this plugin by going to the Plugins tab and searching for `homebridge-bali-blinds` and installing it.\n\nOr, if you prefer to install `homebridge-bali-blinds` from the command line, you can do so by executing:\n\n```\nsudo npm install -g homebridge-bali-blinds\n```\n\n# Configuration\n\nI strongly recommend using the [Homebridge Config UI](https://github.com/oznu/homebridge-config-ui-x) rather than editing your config.json directly. It does a good job of showing you all the options and always generating a valid configuration so you don't get stuck on typos or looking for stray commas in your config.json.\n\nFor those that prefer configuring things directly, add the accessory in `config.json` in your home directory inside `.homebridge`.\n\n```json\n    \"platforms\": [\n        {\n            \"gateways\": [\n                {\n                    \"baliUsername\": \"your-username\",\n                    \"baliPassword\": \"your-password\",\n                    \"baliGatewayId\": \"12345678\", // Optional\n                    \"lowBattery\": 33 // Optional\n                }\n            ],\n            \"platform\": \"BaliBlinds\"\n        }\n    ]\n```\n\n## Options\n\n- `baliUsername`: *(Required)* Username from Bali Motorization mobile app.  It is recommended creating a new user in mobile app with \"Basic User\" permission levels since no Admin or Advanced permissions are required by this plugin.\n- `baliPassword`: *(Required)* Password for the user above.\n- `baliGatewayId`: *(Optional)* The Bali Gateway ID. This can be found in your Bali Motorization mobile app. If you do not specify a Gateway ID, then the first one associated with your account is automatically used.\n- `lowBattery`: *(Optional)* Default 33%. The percentage threshold at which the low battery status will be set on Homebridge blinds accessories.\n\n\n## Multiple Gateways\n\nIf you have multiple Bali Gateways/Hubs, you can add each one to your configuration. You can do this in the Homebridge Config UI but clicking the \"Add to Gateways\" button.\n\n![Screenshot of Homebridge UI](./add-more-gateways.jpg)\n\nAlternatively, you can add a new sectino to the `gateways` array like this:\n\n```json\n    \"platforms\": [\n        {\n            \"gateways\": [\n                {\n                    \"baliUsername\": \"your-username\",\n                    \"baliPassword\": \"your-password\",\n                    \"baliGatewayId\": \"12345678\", // Optional\n                    \"lowBattery\": 33 // Optional\n                },\n                {\n                    \"baliUsername\": \"your-username\",\n                    \"baliPassword\": \"your-password\",\n                    \"baliGatewayId\": \"98765432\", // Optional\n                    \"lowBattery\": 33 // Optional\n                }\n            ],\n            \"platform\": \"BaliBlinds\"\n        }\n    ]\n```\n\n## Where do I find my Gateway ID?\n\nIn the Bali Motorization mobile app, you can find it on the home login screen where you select the gateway to connect to:\n\n\u003cimg src=\"./app-gateway-id.jpg\" width=\"200px\"\u003e\n\n\n# Fun Facts and Random Bits\nI'm not an expert with IoT products, MiOS, Ezlo, Vera, or really any of the technologies used in this plugin. If you see something that doesn't make sense or could be improved please let me know by opening a GitHub issue to discuss. \n\n## Plugin Design\n\nThe design of this plugin is that it communicates with an HTTP API hosted by MiOS and Ezlo. This HTTP API is connected (polled I think) to the Bali Gateway device (Ezlo Atom) that communicates ZWave with the blinds. At first, I considered this solution pretty round-about when I could just speak ZWave directly to the blinds *from* Homebridge but I believe there is some benefit to not requiring more hardware. If you already have a ZWave device connected to Homebridge there are probably other plugins you can use to benefit from the direct communication. \n\n```mermaid\nflowchart LR;\n\tA[Homebridge Plugin] --\u003e B[MiOS/Ezlo HTTP API];\n\tB \u003c--\u003e C[Bali Gateway*];\n\tC --\u003e D[ZWave];\n\tD --\u003e E[Blinds];\n\tF[Mobile App] --\u003e B;\n\tG[Physical Remote**] --\u003e C;\n```\n\n```\n* Bali Gateway is an Ezlo Atom hub usb device\n** The physical remote is Somfy brand device\n```\n\n## Documentation and References\n\nDuring development of this plugin I used various references including but not limited to:\n\n- Legacy MiOS documentation since it appears Bali Motorization is built on legacy cloud infra: https://developer.mios.com/api/legacy-cloud-api/documents/\n- This gist from @cgmartin https://gist.github.com/cgmartin/466bd2d3724de6c04743d61cf0de2066 which I adapted to Bali https://gist.github.com/bostrt/f8189ce83e6fa6fb573aea2f1e76b723\n- The Bali Motorization Android APK for `PK_Oem` and `AppKey` parameters.\n- Ezlo Hub Kit source code which this plugin is very roughly based on: https://github.com/bblacey/ezlo-hub-kit/\n\n# Development\n\nSee [DEVELOPMENT.md](DEVELOPMENT.md)\n\n## Plugin Development Dashboard\n\n[![GitHub](https://img.shields.io/github/license/bostrt/homebridge-bali-blinds?style=for-the-badge)](https://github.com/bostrt/homebridge-bali-blinds/blob/main/LICENSE)\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/bostrt/homebridge-bali-blinds/build.yml?style=for-the-badge)](https://github.com/bostrt/homebridge-bali-blinds/actions)\n[![npm](https://img.shields.io/npm/v/homebridge-bali-blinds?style=for-the-badge)](https://www.npmjs.com/package/homebridge-bali-blinds)\n![Libraries.io dependency status for latest release](https://img.shields.io/librariesio/release/npm/homebridge-bali-blinds?style=for-the-badge)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbostrt%2Fhomebridge-bali-blinds","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbostrt%2Fhomebridge-bali-blinds","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbostrt%2Fhomebridge-bali-blinds/lists"}