homebridge-lanternic 0.1.1 → 0.1.3

package/README.md

@@ -1,12 +1,17 @@
 # Homebridge LanternIC
 
-Homebridge plugin for BLE RGBIC/RGBWIC light strips controlled by the Magic Lantern app.
+[![npm version](https://img.shields.io/npm/v/homebridge-lanternic.svg)](https://www.npmjs.com/package/homebridge-lanternic)
+[![npm downloads](https://img.shields.io/npm/dm/homebridge-lanternic.svg)](https://www.npmjs.com/package/homebridge-lanternic)
+[![CI](https://github.com/Gibsonmb71/homebridge-lanternic/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/Gibsonmb71/homebridge-lanternic/actions/workflows/ci.yml)
+[![Node.js](https://img.shields.io/node/v/homebridge-lanternic.svg)](https://www.npmjs.com/package/homebridge-lanternic)
+[![Homebridge](https://img.shields.io/badge/homebridge-1.8%20%7C%202.x-blue.svg)](https://homebridge.io/)
+[![License](https://img.shields.io/npm/l/homebridge-lanternic.svg)](LICENSE)
 
-The goal is a reliable local-only bridge for the common unbranded Magic Lantern strips and lamps. These devices are usually BLE lights, not Magic Home Wi-Fi devices, so this plugin talks directly to the BLE service used by the Magic Lantern app.
+Homebridge plugin for BLE RGBIC/RGBWIC light strips controlled by the Magic Lantern app.
 
 ## Status
 
-LanternIC is a hardware-tested pre-release plugin. It is designed for production-style Homebridge use, with the important caveat that these unbranded Magic Lantern BLE strips ship with multiple firmware variants.
+These unbranded Magic Lantern BLE strips ship with multiple firmware variants so it's hard to ensure compatibility for all strips.
 
 - HomeKit Lightbulb service
 - On/off with RGB-black fallback plus optional native Magic Lantern power frames
@@ -18,11 +23,11 @@ LanternIC is a hardware-tested pre-release plugin. It is designed for production
 - Command-builder tests for the known Magic Lantern frames
 - Package smoke tests against Homebridge 1 and 2 on Node.js 22 and 24 in CI
 
-Effects, segment control, RGBW white-channel behavior, and startup scenes are deliberately left out until more real devices are tested.
+Effects and segment control are not supported as there is no good way to expose them in Apple Home.
 
 ## Install
 
-Once published to npm, install it like any other Homebridge plugin:
+Install it like any other Homebridge plugin:
 
 ```sh
 sudo npm install -g homebridge-lanternic
@@ -213,7 +218,7 @@ The core frames available here are:
 - Effect speed: `7e0402xxffffff00ef`, where `xx` is 0-100 decimal encoded as one byte
 - Basic effect: `7e0503xx06ffff00ef`
 
-These protocol notes come from Home Assistant community reverse-engineering reports and BLE packet examples:
+> These Magic Lantern BLE frame notes are based on packet-captures from [@kassabov](https://github.com/kassabov) in Home Assistant Core issue [#145934](https://github.com/home-assistant/core/issues/145934). (thanks!)
 
 - Home Assistant Core issue: <https://github.com/home-assistant/core/issues/145934>
 - Home Assistant community thread: <https://community.home-assistant.io/t/new-integration-for-ble-magic-lantern/454055>
@@ -233,8 +238,6 @@ The command builders are isolated so we can add variants if your strip uses a sl
 
 ## Reliability Choices
 
-This plugin avoids the usual BLE plugin failure pattern of overlapping scans, overlapping writes, and stale connections:
-
 - All BLE operations are serialized through a single manager queue.
 - Every characteristic write has a timeout and is retried with exponential backoff.
 - Failed writes force a disconnect and rediscovery.

package/package.json

@@ -2,7 +2,7 @@
   "name": "homebridge-lanternic",
   "displayName": "LanternIC",
   "type": "module",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Homebridge plugin for BLE RGBIC/RGBWIC light strips controlled by the Magic Lantern app.",
   "author": "Gibson Bell",
   "license": "MIT",