From 53b49b55debe4ce2c04d689c3605d3cee1b24a51 Mon Sep 17 00:00:00 2001
From: Chuck <33324927+ChuckBuilds@users.noreply.github.com>
Date: Fri, 4 Sep 2026 11:51:35 -0400
Subject: [PATCH] docs(mqtt-notifications): document the last five settings,
 with real renders

The README explained the MQTT side well -- payload format, topic
wildcards, five Home Assistant examples -- but never listed the plugin's
own settings, and had no images. All 20 schema leaves are now
documented, verified by a token audit, with three renders.

The five that were missing: mqtt.client_id, mqtt.keepalive,
text.scroll_gap_width, update_interval and display_duration.

display_duration is worth its own note. The core reads it as a plugin's
screen time (base_plugin.py:406), but this plugin overrides
get_display_duration() and returns display.default_duration instead, so
setting the root key alone changes nothing. The two defaults agree at
10s, which hides it until someone sets one and not the other. The README
now says which one to set.

update_interval, by contrast, is live: the core schedules update() from
it (plugin_manager.py:809). Both looked dead to a grep of the plugin
alone -- neither name appears in manager.py -- and grepping the core is
what separated the two.

Also documented: the two font routes. text.font_path takes any path,
customization.message_text.font offers the bundled faces as a dropdown,
and the customization block wins when its font loads. Colours come from
text either way, since customization carries no colour keys.

check_plugin.py passes 8/8 with no FAIL.

Carries the docs-tooling changes from #423 and the frame-runner
--display-mode change from #441, which these renders depend on.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 docs/assets/mqtt-notifications/appearance.png | Bin 0 -> 16126 bytes
 docs/assets/mqtt-notifications/hero.png       | Bin 0 -> 792 bytes
 .../assets/mqtt-notifications/panel-sizes.png | Bin 0 -> 10715 bytes
 docs/assets/mqtt-notifications/scroll.png     | Bin 0 -> 10324 bytes
 docs/assets/mqtt-notifications/shots.json     | 333 ++++++++++++++++++
 plugins.json                                  |   4 +-
 plugins/mqtt-notifications/README.md          |  59 ++++
 plugins/mqtt-notifications/manifest.json      |  11 +-
 .../docs_render_support/_docs_frame_runner.py |  15 +-
 scripts/docs_render_support/sitecustomize.py  |  55 ++-
 scripts/render_docs_assets.py                 |   3 +
 11 files changed, 472 insertions(+), 8 deletions(-)
 create mode 100644 docs/assets/mqtt-notifications/appearance.png
 create mode 100644 docs/assets/mqtt-notifications/hero.png
 create mode 100644 docs/assets/mqtt-notifications/panel-sizes.png
 create mode 100644 docs/assets/mqtt-notifications/scroll.png
 create mode 100644 docs/assets/mqtt-notifications/shots.json

diff --git a/docs/assets/mqtt-notifications/appearance.png b/docs/assets/mqtt-notifications/appearance.png
new file mode 100644
index 0000000000000000000000000000000000000000..3724f0edf74e4374b9125537df7f554a04922451
GIT binary patch
literal 16126
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
QYey)_t6t5OyLJD60Se}`Pyhe`

literal 0
HcmV?d00001

diff --git a/docs/assets/mqtt-notifications/hero.png b/docs/assets/mqtt-notifications/hero.png
new file mode 100644
index 0000000000000000000000000000000000000000..6dd116b7b76c885c24650743bbdce530d7f98d94
GIT binary patch
literal 792
zcmeAS@N?(olHy`uVBq!ia0y~yU<NW74sb95Nt?%$KQJ&b-S>2H45_&F_U=WYCItc3
z3)zqV|KC*W<d(oa=X2bm8FwAa%ostM1~aHD-BSBz*ShoZwKCi>3u@0@nOgoXWVU`e
zQ_trjP6h@>4h9DXCI*291_l-dhK8AQa^-`|86N+rWjw+qz|g?J!l1yw$iU$M3=IJW
zhkdVE%a+TZ-QhKD+v4w14|goKzp0zi`|-`4{Bv*4m|E{$H{*H#@APT)Thw>o{aTe4
z#mL0)NK^vFn8>wUI&;hN{(ql+-6Ht$&4uaLdcv>Pyfuh_C%=FFzQ;fFdv}T|Fet<|
z!fgdP!eH{|TMh57$bNa1wyD^ctKoV7&6W9g?6+c3DiE5Wxr6zSpXp7h(!|wa+ZpHC
z7tj5@L+jbEy(g1cQM?QCy+ZQp166O|<=w9T_vGFu$<?B(zIv?=`#K@F>SNF9_Y8Zb
zUWXf=kC-Z^4G99|5P2)o$>5+BUc2gJ56~TGLCG-K!GrMptKW`A_9@v%ft>2;>gTe~
HDWM4fnxL#x

literal 0
HcmV?d00001

diff --git a/docs/assets/mqtt-notifications/panel-sizes.png b/docs/assets/mqtt-notifications/panel-sizes.png
new file mode 100644
index 0000000000000000000000000000000000000000..606a053a1f8b85cc233fca74cb319613530a8795
GIT binary patch
literal 10715
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
bwsA%E20b38<fV?`)@mQrJCO8)^?&{sq5*b%

literal 0
HcmV?d00001

diff --git a/docs/assets/mqtt-notifications/scroll.png b/docs/assets/mqtt-notifications/scroll.png
new file mode 100644
index 0000000000000000000000000000000000000000..2340964351f91c6615b89a4b11fcf1262f2706c9
GIT binary patch
literal 10324
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
BO40xT

literal 0
HcmV?d00001

diff --git a/docs/assets/mqtt-notifications/shots.json b/docs/assets/mqtt-notifications/shots.json
new file mode 100644
index 00000000..9f7f1c14
--- /dev/null
+++ b/docs/assets/mqtt-notifications/shots.json
@@ -0,0 +1,333 @@
+{
+  "plugin": "mqtt-notifications",
+  "_comment": "display() reads self.current_message, a dict the MQTT handler builds with type, content, duration, priority, timestamp and topic; content carries text and/or image. The fixture seeds that dict directly so no broker is needed, and clears text_image_cache and image_cache because the handler clears them whenever a new message arrives. text.scroll is on by default, so the scrolling shots use frames -- frame 0 of a scroller is blank. Messages are invented.",
+  "defaults": {
+    "width": 128,
+    "height": 32,
+    "scale": 6,
+    "skip_update": true,
+    "freeze_time": "2026-09-04T12:00:00+00:00",
+    "config": {
+      "enabled": true,
+      "mqtt": {
+        "host": "localhost",
+        "port": 1883
+      }
+    }
+  },
+  "shots": [
+    {
+      "name": "hero",
+      "attrs": {
+        "current_message": {
+          "type": "notification",
+          "content": {
+            "text": "Laundry finished in the garage"
+          },
+          "duration": 10,
+          "priority": "normal",
+          "timestamp": 9000000000.0,
+          "topic": "homeassistant/ledmatrix/notify"
+        },
+        "text_image_cache": null,
+        "image_cache": null
+      },
+      "frames": 60
+    },
+    {
+      "name": "scroll-on",
+      "standalone": false,
+      "attrs": {
+        "current_message": {
+          "type": "notification",
+          "content": {
+            "text": "Laundry finished in the garage"
+          },
+          "duration": 10,
+          "priority": "normal",
+          "timestamp": 9000000000.0,
+          "topic": "homeassistant/ledmatrix/notify"
+        },
+        "text_image_cache": null,
+        "image_cache": null
+      },
+      "frames": 60
+    },
+    {
+      "name": "scroll-off",
+      "standalone": false,
+      "attrs": {
+        "current_message": {
+          "type": "notification",
+          "content": {
+            "text": "Doorbell"
+          },
+          "duration": 10,
+          "priority": "normal",
+          "timestamp": 9000000000.0,
+          "topic": "homeassistant/ledmatrix/notify"
+        },
+        "text_image_cache": null,
+        "image_cache": null
+      },
+      "config": {
+        "enabled": true,
+        "mqtt": {
+          "host": "localhost",
+          "port": 1883
+        },
+        "text": {
+          "scroll": false
+        }
+      }
+    },
+    {
+      "name": "colour",
+      "standalone": false,
+      "attrs": {
+        "current_message": {
+          "type": "notification",
+          "content": {
+            "text": "Doorbell"
+          },
+          "duration": 10,
+          "priority": "normal",
+          "timestamp": 9000000000.0,
+          "topic": "homeassistant/ledmatrix/notify"
+        },
+        "text_image_cache": null,
+        "image_cache": null
+      },
+      "config": {
+        "enabled": true,
+        "mqtt": {
+          "host": "localhost",
+          "port": 1883
+        },
+        "text": {
+          "scroll": false,
+          "text_color": [
+            0,
+            220,
+            255
+          ]
+        }
+      }
+    },
+    {
+      "name": "small-font",
+      "standalone": false,
+      "attrs": {
+        "current_message": {
+          "type": "notification",
+          "content": {
+            "text": "Laundry finished in the garage"
+          },
+          "duration": 10,
+          "priority": "normal",
+          "timestamp": 9000000000.0,
+          "topic": "homeassistant/ledmatrix/notify"
+        },
+        "text_image_cache": null,
+        "image_cache": null
+      },
+      "config": {
+        "enabled": true,
+        "mqtt": {
+          "host": "localhost",
+          "port": 1883
+        },
+        "text": {
+          "scroll": false
+        },
+        "customization": {
+          "message_text": {
+            "font": "4x6-font.ttf",
+            "font_size": 6
+          }
+        }
+      }
+    },
+    {
+      "name": "size-64x32",
+      "width": 64,
+      "height": 32,
+      "standalone": false,
+      "attrs": {
+        "current_message": {
+          "type": "notification",
+          "content": {
+            "text": "Doorbell"
+          },
+          "duration": 10,
+          "priority": "normal",
+          "timestamp": 9000000000.0,
+          "topic": "homeassistant/ledmatrix/notify"
+        },
+        "text_image_cache": null,
+        "image_cache": null
+      },
+      "config": {
+        "enabled": true,
+        "mqtt": {
+          "host": "localhost",
+          "port": 1883
+        },
+        "text": {
+          "scroll": false
+        }
+      }
+    },
+    {
+      "name": "size-128x32",
+      "width": 128,
+      "height": 32,
+      "standalone": false,
+      "attrs": {
+        "current_message": {
+          "type": "notification",
+          "content": {
+            "text": "Doorbell"
+          },
+          "duration": 10,
+          "priority": "normal",
+          "timestamp": 9000000000.0,
+          "topic": "homeassistant/ledmatrix/notify"
+        },
+        "text_image_cache": null,
+        "image_cache": null
+      },
+      "config": {
+        "enabled": true,
+        "mqtt": {
+          "host": "localhost",
+          "port": 1883
+        },
+        "text": {
+          "scroll": false
+        }
+      }
+    },
+    {
+      "name": "size-128x64",
+      "width": 128,
+      "height": 64,
+      "standalone": false,
+      "attrs": {
+        "current_message": {
+          "type": "notification",
+          "content": {
+            "text": "Doorbell"
+          },
+          "duration": 10,
+          "priority": "normal",
+          "timestamp": 9000000000.0,
+          "topic": "homeassistant/ledmatrix/notify"
+        },
+        "text_image_cache": null,
+        "image_cache": null
+      },
+      "config": {
+        "enabled": true,
+        "mqtt": {
+          "host": "localhost",
+          "port": 1883
+        },
+        "text": {
+          "scroll": false
+        }
+      }
+    },
+    {
+      "name": "size-256x32",
+      "width": 256,
+      "height": 32,
+      "standalone": false,
+      "attrs": {
+        "current_message": {
+          "type": "notification",
+          "content": {
+            "text": "Doorbell"
+          },
+          "duration": 10,
+          "priority": "normal",
+          "timestamp": 9000000000.0,
+          "topic": "homeassistant/ledmatrix/notify"
+        },
+        "text_image_cache": null,
+        "image_cache": null
+      },
+      "config": {
+        "enabled": true,
+        "mqtt": {
+          "host": "localhost",
+          "port": 1883
+        },
+        "text": {
+          "scroll": false
+        }
+      }
+    }
+  ],
+  "composites": [
+    {
+      "name": "scroll",
+      "columns": 1,
+      "cells": [
+        {
+          "shot": "scroll-on",
+          "label": "text.scroll: true",
+          "sublabel": "the default; a long message scrolls past"
+        },
+        {
+          "shot": "scroll-off",
+          "label": "text.scroll: false",
+          "sublabel": "the message is drawn once, centred"
+        }
+      ]
+    },
+    {
+      "name": "appearance",
+      "columns": 1,
+      "cells": [
+        {
+          "shot": "scroll-off",
+          "label": "defaults",
+          "sublabel": "PressStart2P at 8px, white on black"
+        },
+        {
+          "shot": "colour",
+          "label": "text.text_color",
+          "sublabel": "any RGB triple"
+        },
+        {
+          "shot": "small-font",
+          "label": "customization.message_text",
+          "sublabel": "4x6-font.ttf at 6px fits a longer message without scrolling"
+        }
+      ]
+    },
+    {
+      "name": "panel-sizes",
+      "columns": 2,
+      "cells": [
+        {
+          "shot": "size-64x32",
+          "label": "64 x 32"
+        },
+        {
+          "shot": "size-128x32",
+          "label": "128 x 32"
+        },
+        {
+          "shot": "size-128x64",
+          "label": "128 x 64"
+        },
+        {
+          "shot": "size-256x32",
+          "label": "256 x 32"
+        }
+      ]
+    }
+  ]
+}
diff --git a/plugins.json b/plugins.json
index f818927f..193a565e 100644
--- a/plugins.json
+++ b/plugins.json
@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "last_updated": "2026-09-03",
+  "last_updated": "2026-09-04",
   "plugins": [
     {
       "id": "cricket-scoreboard",
@@ -510,7 +510,7 @@
       "last_updated": "2026-09-02",
       "verified": true,
       "screenshot": "",
-      "latest_version": "1.2.0"
+      "latest_version": "1.2.1"
     },
     {
       "id": "music",
diff --git a/plugins/mqtt-notifications/README.md b/plugins/mqtt-notifications/README.md
index 6948e8b0..b30111e3 100644
--- a/plugins/mqtt-notifications/README.md
+++ b/plugins/mqtt-notifications/README.md
@@ -72,6 +72,65 @@ Add the following to your `config/config.json`:
 }
 ```
 
+## What it looks like
+
+![A notification on a 128x32 panel](../../docs/assets/mqtt-notifications/hero.png)
+
+A message is drawn as a single line of text. Long messages scroll by default;
+short ones fit as they are.
+
+![Scrolling on and off](../../docs/assets/mqtt-notifications/scroll.png)
+
+`text.scroll` is on by default. With it off the message is drawn once and
+centred, which suits short alerts and costs no CPU between redraws.
+
+### Appearance
+
+![Default, recoloured, and a smaller face](../../docs/assets/mqtt-notifications/appearance.png)
+
+| Key | Default | What it does |
+|---|---|---|
+| `text.font_path` | `assets/fonts/PressStart2P-Regular.ttf` | Font file, TTF or BDF. Relative to the project root, or absolute. |
+| `text.font_size` | `8` | Size in pixels. |
+| `text.text_color` | `[255, 255, 255]` | RGB triple. |
+| `text.background_color` | `[0, 0, 0]` | RGB triple. |
+| `text.scroll` | `true` | Scroll the message rather than drawing it once. |
+| `text.scroll_speed` | `30` | Pixels per second. Higher is faster. |
+| `text.scroll_gap_width` | `32` | Pixels of gap between scroll loops. |
+| `customization.message_text.font` | `PressStart2P-Regular.ttf` | Picked from a list in the web UI: `PressStart2P-Regular.ttf`, `4x6-font.ttf`, `5by7.regular.ttf`, `5x7.bdf`, `4x6.bdf`. Overrides `text.font_path` when set. |
+| `customization.message_text.font_size` | `8` | Size for that face. |
+
+The two font routes exist because `text.font_path` takes any path while
+`customization.message_text.font` offers a dropdown of the bundled faces. The
+`customization` block wins when it loads successfully; colours come from `text`
+either way, since `customization` carries no colour keys.
+
+### Panel sizes
+
+![The card at four panel sizes](../../docs/assets/mqtt-notifications/panel-sizes.png)
+
+The plugin passes the render-safety harness on every supported size.
+
+### Connection and timing settings
+
+| Key | Default | What it does |
+|---|---|---|
+| `enabled` | `false` | Master on/off switch. Off by default. |
+| `mqtt.host` | `localhost` | Broker hostname or IP. |
+| `mqtt.port` | `1883` | Broker port. |
+| `mqtt.username` | `""` | Optional. |
+| `mqtt.password` | `""` | Optional. |
+| `mqtt.client_id` | `ledmatrix-mqtt-notifications` | Client id the plugin connects with. Change it if you run two boards against one broker, since a broker will disconnect a duplicate id. |
+| `mqtt.keepalive` | `60` | Keepalive interval in seconds. |
+| `mqtt.topics` | `["homeassistant/ledmatrix/+"]` | Topics to subscribe to. `+` matches one level, `#` matches the rest. |
+| `display.default_duration` | `10` | How long a message holds the screen when its payload does not set `duration`. |
+| `display_duration` | `10` | **Inert in this plugin.** The core reads this as a plugin's screen time, but this plugin overrides that accessor and returns `display.default_duration` instead, so setting the root key alone changes nothing. Set `display.default_duration`. |
+| `update_interval` | `60` | How often the core calls the plugin's `update()`, which checks connection health. The MQTT client itself runs on its own thread, so this does not affect how quickly a message appears. |
+
+`mqtt`, `display`, `text`, `customization` and `customization.message_text` all
+set `additionalProperties: false`, so a misspelled key is rejected rather than
+quietly ignored.
+
 ## Message Format
 
 Send JSON messages to the configured MQTT topics. The message format is:
diff --git a/plugins/mqtt-notifications/manifest.json b/plugins/mqtt-notifications/manifest.json
index 804e2989..8bf2a6c5 100644
--- a/plugins/mqtt-notifications/manifest.json
+++ b/plugins/mqtt-notifications/manifest.json
@@ -1,7 +1,7 @@
 {
   "id": "mqtt-notifications",
   "name": "MQTT Notifications",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "author": "ChuckBuilds",
   "description": "Display text or images from HomeAssistant via MQTT. Supports dynamic MQTT topics with wildcard support for flexible notification handling that interrupts the normal display rotation.",
   "category": "integration",
@@ -18,6 +18,15 @@
   "entry_point": "manager.py",
   "class_name": "MQTTNotificationsPlugin",
   "versions": [
+    {
+      "version": "1.2.1",
+      "released": "2026-09-02",
+      "notes": "Load a bitmap font at its own pixel size, and drop one that has no font file. A .bdf exists at exactly one pixel size and FreeType rejects any other, so every .bdf in the font picker failed at the configured font_size and silently fell back to the default face -- choosing one appeared to do nothing. Bitmap faces are now retried at the size the file's PIXEL_SIZE header declares. cozette.bdf is removed from the picker: the file is shipped by neither the core nor the plugin, so it could only ever fall back. Same fix already landed for clock-simple, news and tide-display, which share this loader.",
+      "ledmatrix_min_version": "2.0.0",
+      "changes": [
+        "Documented the five remaining settings and added rendered examples of the scroll toggle, the appearance options, and four panel sizes."
+      ]
+    },
     {
       "version": "1.2.0",
       "released": "2026-09-02",
diff --git a/scripts/docs_render_support/_docs_frame_runner.py b/scripts/docs_render_support/_docs_frame_runner.py
index 6f85f52d..2ddc24eb 100644
--- a/scripts/docs_render_support/_docs_frame_runner.py
+++ b/scripts/docs_render_support/_docs_frame_runner.py
@@ -39,6 +39,10 @@ def main() -> int:
                              "needed when the shot supplies its state directly")
     parser.add_argument("--frame-seconds", type=float, default=0.05,
                         help="Frozen-clock seconds to advance between frames")
+    parser.add_argument("--display-mode", default=None,
+                        help="Display mode to render, for plugins that declare more "
+                             "than one. Matches render_plugin.py, so a scrolling shot "
+                             "can name its mode the same way a still one does.")
     parser.add_argument("--output", required=True)
     args = parser.parse_args()
 
@@ -92,7 +96,16 @@ def main() -> int:
     # force_clear only on the first frame, so a plugin that treats it as "start
     # over" does not restart its scroll on every step.
     for frame in range(max(1, args.frames)):
-        instance.display(force_clear=(frame == 0))
+        if args.display_mode:
+            try:
+                instance.display(force_clear=(frame == 0),
+                                 display_mode=args.display_mode)
+            except TypeError:
+                # Same fallback render_plugin.py uses: a plugin whose display()
+                # takes no mode renders its default screen rather than failing.
+                instance.display(force_clear=(frame == 0))
+        else:
+            instance.display(force_clear=(frame == 0))
         if advance is not None:
             advance(args.frame_seconds)
 
diff --git a/scripts/docs_render_support/sitecustomize.py b/scripts/docs_render_support/sitecustomize.py
index 44eafa3a..64fbb438 100644
--- a/scripts/docs_render_support/sitecustomize.py
+++ b/scripts/docs_render_support/sitecustomize.py
@@ -89,12 +89,59 @@ def advance(seconds):
     _WANTED = _json.loads(_ATTRS)
     _TARGET = "src.plugin_system.plugin_loader"
 
+    def _resolve(instance, path):
+        """Walk a dotted path to the object that owns the final attribute.
+
+        The sports scoreboards keep their per-mode state on sub-managers rather
+        than on the plugin -- self._managers["live"].current_game -- so a shot
+        that can only set top-level attributes cannot reach the game it wants
+        to draw. A segment is tried as a mapping key first, then as an
+        attribute, so both self._managers["live"] and self.live_manager work.
+        """
+        parts = path.split(".")
+        target = instance
+        for part in parts[:-1]:
+            if hasattr(target, "get") and not hasattr(target, part):
+                nxt = target.get(part)
+            else:
+                nxt = getattr(target, part, None)
+                if nxt is None and hasattr(target, "get"):
+                    nxt = target.get(part)
+            if nxt is None:
+                return None, None
+            target = nxt
+        return target, parts[-1]
+
+    def _coerce(name, value):
+        """Turn JSON into the shapes the plugins actually hold.
+
+        A shots file can only carry JSON, but plugin state is not all strings
+        and lists: colours are tuples throughout the core, and a logo field is
+        a pathlib.Path -- the sports renderers call logo_path.parent, so a
+        string there raises AttributeError and the card silently fails to draw.
+        """
+        if isinstance(value, list) and len(value) == 3 and all(
+                isinstance(v, int) for v in value):
+            return tuple(value)  # colours are tuples everywhere in the core
+        if isinstance(value, str) and name.endswith("_path") and value:
+            import pathlib as _pathlib
+            return _pathlib.Path(value)
+        if isinstance(value, dict):
+            return {k: _coerce(k, v) for k, v in value.items()}
+        if isinstance(value, list):
+            return [_coerce(name, v) for v in value]
+        return value
+
     def _apply(instance):
         for name, value in _WANTED.items():
-            if isinstance(value, list) and len(value) == 3 and all(
-                    isinstance(v, int) for v in value):
-                value = tuple(value)  # colours are tuples everywhere in the core
-            setattr(instance, name, value)
+            value = _coerce(name.rsplit(".", 1)[-1], value)
+            owner, attr = _resolve(instance, name)
+            if owner is None:
+                continue  # the path does not exist on this plugin; leave it alone
+            if hasattr(owner, "__setitem__") and not hasattr(owner, attr):
+                owner[attr] = value
+            else:
+                setattr(owner, attr, value)
         return instance
 
     class _PatchingLoader:
diff --git a/scripts/render_docs_assets.py b/scripts/render_docs_assets.py
index fa38f5f9..2ca204e6 100644
--- a/scripts/render_docs_assets.py
+++ b/scripts/render_docs_assets.py
@@ -268,6 +268,9 @@ def render_shot(
     mock_path = resolve_mock_data(mock_spec, shot_list_dir, tmpdir, name)
     if mock_path:
         cmd += ["--mock-data", str(mock_path)]
+    display_mode = shot.get("display_mode", defaults.get("display_mode"))
+    if display_mode:
+        cmd += ["--display-mode", str(display_mode)]
     if shot.get("skip_update", defaults.get("skip_update", False)):
         cmd.append("--skip-update")