@mdjhnson/homebridge-yoto 0.1.0 → 0.1.2

package/README.md

@@ -54,10 +54,10 @@ All options live under **Accessory Services** in the plugin settings.
 
 **Playback**
 - **Playback Controls**: Adds a play/pause switch and a volume dimmer to each player's bridged accessory.
-- **External Smart Speaker**: Publishes a separate Smart Speaker accessory for playback and volume.
+- **External Smart Speaker**: Publishes a separate Smart Speaker accessory for Home app scenes and automations (pause, resume, set volume). The Home app shows *"Controls not available"* when you open it, because iOS only offers live controls for AirPlay speakers. It does not make the Yoto an AirPlay target.
 - **TV Playback Accessory**: Publishes a separate TV-style accessory. Its inputs play your card controls and shortcuts, and you control it with the iOS remote.
 
-External accessories must be added by hand in the Home app (**Add Accessory → More options**) using the setup code in the Homebridge log.
+External accessories must be added by hand in the Home app (**Add Accessory → More options**) using the setup code in the Homebridge log. Each one listens on its own port (logged as `... is running on port N`), so open those ports if Homebridge runs behind a firewall, or set a fixed port range under Homebridge **Settings → Network**.
 
 **Card Controls** (`services.cardControls`)
 - A switch on each player that plays the card ID you configure.

package/config.schema.json

@@ -67,13 +67,13 @@
             "title": "External Smart Speaker",
             "type": "boolean",
             "default": false,
-            "description": "Publish an external Smart Speaker accessory for playback and volume controls. Requires additional pairing steps and appears as a separate accessory."
+            "description": "Publish an external Smart Speaker accessory for use in Home app scenes and automations (pause, resume, set volume). The Home app shows \"Controls not available\" for it; for tap-to-control use Playback Controls or the TV Playback Accessory. Requires pairing and its own network port."
           },
           "television": {
             "title": "TV Playback Accessory",
             "type": "boolean",
             "default": false,
-            "description": "Publish an external playback accessory using the TV service with input and speaker controls. Requires additional pairing steps and appears as a separate accessory."
+            "description": "Publish an external TV-style accessory: play/pause and volume from the iPhone remote, and inputs that play your card controls and shortcuts. Requires pairing and its own network port."
           },
           "battery": {
             "title": "Battery",
@@ -188,7 +188,7 @@
         },
         {
           "type": "help",
-          "helpvalue": "<p><strong>Playback Controls:</strong> Enable a bridged switch + dimmer for play/pause and volume. <strong>External Smart Speaker:</strong> publishes a separate accessory and requires additional pairing steps in the Home app. <strong>TV Playback Accessory:</strong> publishes an external playback accessory with input and speaker controls.</p>"
+          "helpvalue": "<p><strong>Playback Controls:</strong> Enable a bridged switch + dimmer for play/pause and volume. <strong>External Smart Speaker:</strong> a separate accessory for scenes and automations only (the Home app shows \"Controls not available\"). <strong>TV Playback Accessory:</strong> a separate accessory controlled with the iPhone remote, with inputs for card controls and shortcuts. External accessories need pairing and each uses its own network port.</p>"
         },
         "services.playbackControls",
         "services.smartSpeaker",
@@ -209,6 +209,7 @@
         {
           "key": "services.cardControls",
           "type": "array",
+          "startEmpty": true,
           "buttonText": "Add Card Control",
           "items": [
             "services.cardControls[].label",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mdjhnson/homebridge-yoto",
   "description": "Control your Yoto players through Apple HomeKit with real-time MQTT updates",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "author": "mdjhnson (https://github.com/mdjhnson)",
   "contributors": [
     "Bret Comnes <bcomnes@gmail.com> (https://bret.io)"