From c0d503e836215ca369e28663970a36bca86e1b21 Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 09:48:06 +0200
Subject: [PATCH 01/22] Rebuild the received universe from a zeroed base in
 sacn-in

Incoming sACN payloads omit channels whose value is 0, so overlaying them
onto the retained state left channels that faded to 0 stuck at their old
value. This corrupted the full-universe output, the keepalive re-emit and
change detection alike.

Treat every received data packet as authoritative for all 512 slots:
rebuild the full state from a zeroed base each frame and derive changes by
diffing against the previous state, so a channel dropping to 0 is now
detected and emitted correctly.
---
 dist/nodes/sacn-in/sacn-in.js | 46 ++++++++++++++-----------------
 src/nodes/sacn-in/sacn-in.ts  | 52 ++++++++++++++++-------------------
 2 files changed, 43 insertions(+), 55 deletions(-)

diff --git a/dist/nodes/sacn-in/sacn-in.js b/dist/nodes/sacn-in/sacn-in.js
index f35f6f9..81fd67e 100644
--- a/dist/nodes/sacn-in/sacn-in.js
+++ b/dist/nodes/sacn-in/sacn-in.js
@@ -50,8 +50,7 @@ class NodeHandler {
         });
         if (config.mode === "passthrough") {
             this.sACN.on("packet", (packet) => {
-                const changed = this.hasChanges(packet.payload, packet.universe);
-                const payload = this.parsePayload(packet.payload, packet.universe);
+                const { payload, changed } = this.applyFrame(packet.payload, packet.universe);
                 if (this.trigger === "always" || changed) {
                     this.sendData({
                         universe: packet.universe,
@@ -65,7 +64,7 @@ class NodeHandler {
         }
         else {
             this.sACN.on("changed", (data) => {
-                const payload = this.parsePayload(data.payload, data.universe);
+                const { payload } = this.applyFrame(data.payload, data.universe);
                 if (this.trigger !== "always") {
                     this.sendData({
                         universe: data.universe,
@@ -128,32 +127,27 @@ class NodeHandler {
         }
         return universe;
     }
-    hasChanges(payload, universe) {
-        const full = this.data?.get(universe);
-        if (full === undefined) {
-            return true;
-        }
-        return Object.keys(payload).some((key) => {
-            const ch = parseInt(key, 10);
-            return full[ch] !== payload[ch];
-        });
-    }
-    parsePayload(payload, universe) {
-        const full = this.data?.get(universe) ?? this.getNulledUniverse();
-        Object.keys(payload).forEach((key) => {
+    applyFrame(incoming, universe) {
+        const previous = this.data?.get(universe);
+        const full = this.getNulledUniverse();
+        Object.keys(incoming).forEach((key) => {
             const ch = parseInt(key, 10);
-            full[ch] = payload[ch];
+            if (ch >= 1 && ch <= 512) {
+                full[ch] = incoming[ch];
+            }
         });
-        this.data?.set(universe, full);
-        if (this.config.output === "changes") {
-            const changes = {};
-            Object.keys(payload).forEach((key) => {
-                const ch = parseInt(key, 10);
-                changes[ch] = payload[ch];
-            });
-            return changes;
+        let changed = false;
+        const changes = {};
+        for (let ch = 1; ch <= 512; ch++) {
+            const before = previous ? previous[ch] : 0;
+            if (before !== full[ch]) {
+                changed = true;
+                changes[ch] = full[ch];
+            }
         }
-        return full;
+        this.data?.set(universe, full);
+        const payload = this.config.output === "changes" ? changes : full;
+        return { payload, changed };
     }
     sendData(msg) {
         this.node.send(msg);
diff --git a/src/nodes/sacn-in/sacn-in.ts b/src/nodes/sacn-in/sacn-in.ts
index e4ddbe9..a75c733 100644
--- a/src/nodes/sacn-in/sacn-in.ts
+++ b/src/nodes/sacn-in/sacn-in.ts
@@ -98,8 +98,7 @@ class NodeHandler {
     // handle sacn packets according to the configured output trigger
     if (config.mode === "passthrough") {
       this.sACN.on("packet", (packet: Packet) => {
-        const changed = this.hasChanges(packet.payload, packet.universe);
-        const payload = this.parsePayload(packet.payload, packet.universe);
+        const { payload, changed } = this.applyFrame(packet.payload, packet.universe);
 
         if (this.trigger === "always" || changed) {
           this.sendData({
@@ -114,7 +113,7 @@ class NodeHandler {
     } else {
       // htp / ltp — merged output
       (this.sACN as MergingReceiver).on("changed", (data) => {
-        const payload = this.parsePayload(data.payload, data.universe);
+        const { payload } = this.applyFrame(data.payload, data.universe);
 
         // in "always" mode the packet listener below emits on every packet instead
         if (this.trigger !== "always") {
@@ -205,40 +204,35 @@ class NodeHandler {
     return universe;
   }
 
-  protected hasChanges(payload: DMXValues, universe: number): boolean {
-    const full = this.data?.get(universe);
-    if (full === undefined) {
-      return true;
-    }
+  protected applyFrame(incoming: DMXValues, universe: number): { payload: DMXValues; changed: boolean } {
+    // an sACN data packet always describes the complete universe; channels that are
+    // absent from the received payload are deliberately 0, not unchanged. Rebuild the
+    // full state from a zeroed base so a channel fading to 0 is reflected correctly.
+    const previous = this.data?.get(universe);
+    const full = this.getNulledUniverse();
 
-    return Object.keys(payload).some((key) => {
+    Object.keys(incoming).forEach((key) => {
       const ch = parseInt(key, 10);
-      return full[ch] !== payload[ch];
+      if (ch >= 1 && ch <= 512) {
+        full[ch] = incoming[ch];
+      }
     });
-  }
 
-  protected parsePayload(payload: DMXValues, universe: number): DMXValues {
-    // always maintain the full state of the universe (needed for keepalive / clear)
-    const full: DMXValues = this.data?.get(universe) ?? this.getNulledUniverse();
-
-    Object.keys(payload).forEach((key) => {
-      const ch = parseInt(key, 10);
-      full[ch] = payload[ch];
-    });
+    let changed = false;
+    const changes: DMXValues = {};
+    for (let ch = 1; ch <= 512; ch++) {
+      const before = previous ? previous[ch] : 0;
+      if (before !== full[ch]) {
+        changed = true;
+        changes[ch] = full[ch];
+      }
+    }
 
     this.data?.set(universe, full);
 
-    if (this.config.output === "changes") {
-      const changes: DMXValues = {};
-      Object.keys(payload).forEach((key) => {
-        const ch = parseInt(key, 10);
-        changes[ch] = payload[ch];
-      });
-
-      return changes;
-    }
+    const payload = this.config.output === "changes" ? changes : full;
 
-    return full;
+    return { payload, changed };
   }
 
   protected sendData(msg: NodeMessage): void {

From cdf7c071667521f9be0d893739ad59c17f607c6b Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 09:49:30 +0200
Subject: [PATCH 02/22] Emit copies of the cached universe state from sacn-in

sendData now clones the message payload before sending, so a downstream
node can never mutate the receiver's internal universe cache by holding on
to the emitted object. emitFull no longer needs its own defensive copy.
---
 dist/nodes/sacn-in/sacn-in.js | 5 ++++-
 src/nodes/sacn-in/sacn-in.ts  | 8 +++++++-
 2 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/dist/nodes/sacn-in/sacn-in.js b/dist/nodes/sacn-in/sacn-in.js
index 81fd67e..568ffa3 100644
--- a/dist/nodes/sacn-in/sacn-in.js
+++ b/dist/nodes/sacn-in/sacn-in.js
@@ -150,12 +150,15 @@ class NodeHandler {
         return { payload, changed };
     }
     sendData(msg) {
+        if (msg.payload && typeof msg.payload === "object") {
+            msg = { ...msg, payload: { ...msg.payload } };
+        }
         this.node.send(msg);
         this.resetKeepalive();
     }
     emitFull(universe) {
         const full = this.data?.get(universe) ?? this.getNulledUniverse();
-        this.sendData({ universe, payload: { ...full } });
+        this.sendData({ universe, payload: full });
     }
     resetKeepalive() {
         if (this.trigger !== "interval") {
diff --git a/src/nodes/sacn-in/sacn-in.ts b/src/nodes/sacn-in/sacn-in.ts
index a75c733..ece97d5 100644
--- a/src/nodes/sacn-in/sacn-in.ts
+++ b/src/nodes/sacn-in/sacn-in.ts
@@ -236,13 +236,19 @@ class NodeHandler {
   }
 
   protected sendData(msg: NodeMessage): void {
+    // never hand out a reference to the cached universe state; a downstream node
+    // must not be able to mutate our internal data by holding on to the payload
+    if (msg.payload && typeof msg.payload === "object") {
+      msg = { ...msg, payload: { ...(msg.payload as DMXValues) } };
+    }
+
     this.node.send(msg);
     this.resetKeepalive();
   }
 
   protected emitFull(universe: number): void {
     const full = this.data?.get(universe) ?? this.getNulledUniverse();
-    this.sendData({ universe, payload: { ...full } });
+    this.sendData({ universe, payload: full });
   }
 
   protected resetKeepalive(): void {

From e2e1195f594eea87e2705d4c05a6b3b0d106c9f6 Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 09:50:25 +0200
Subject: [PATCH 03/22] Handle receiver and sender socket errors without
 crashing

Both nodes create an sACN socket but never listened for its "error" event.
An emitted error with no listener is an uncaught exception in Node.js and
could bring down the entire Node-RED runtime (e.g. a busy port or a bad
interface address). Attach an error listener to each that logs the error
and shows it on the node, so the failure is visible but the runtime and the
remaining flows keep going.
---
 dist/nodes/sacn-in/sacn-in.js   | 4 ++++
 dist/nodes/sacn-out/sacn-out.js | 4 ++++
 src/nodes/sacn-in/sacn-in.ts    | 9 +++++++++
 src/nodes/sacn-out/sacn-out.ts  | 8 ++++++++
 4 files changed, 25 insertions(+)

diff --git a/dist/nodes/sacn-in/sacn-in.js b/dist/nodes/sacn-in/sacn-in.js
index 568ffa3..7b72fad 100644
--- a/dist/nodes/sacn-in/sacn-in.js
+++ b/dist/nodes/sacn-in/sacn-in.js
@@ -41,6 +41,10 @@ class NodeHandler {
             default:
                 throw new Error("[node-red-sacn] None or invalid mode selected.");
         }
+        this.sACN.on("error", (err) => {
+            this.node.error(err);
+            this.node.status({ fill: "red", shape: "dot", text: err.message || "receiver error" });
+        });
         this.node.on("close", () => {
             this.sACN.close();
             if (this.keepaliveTimer) {
diff --git a/dist/nodes/sacn-out/sacn-out.js b/dist/nodes/sacn-out/sacn-out.js
index 5b95719..4bc59f4 100644
--- a/dist/nodes/sacn-out/sacn-out.js
+++ b/dist/nodes/sacn-out/sacn-out.js
@@ -24,6 +24,10 @@ class NodeHandler {
             this.options.port = 5568;
         }
         this.sACN = new sacn_1.Sender(this.options);
+        this.sACN.on("error", (err) => {
+            this.node.error(err);
+            this.node.status({ fill: "red", shape: "dot", text: err.message || "sender error" });
+        });
         this.node.on("close", () => {
             this.sACN.close();
         });
diff --git a/src/nodes/sacn-in/sacn-in.ts b/src/nodes/sacn-in/sacn-in.ts
index ece97d5..4ee0035 100644
--- a/src/nodes/sacn-in/sacn-in.ts
+++ b/src/nodes/sacn-in/sacn-in.ts
@@ -83,6 +83,15 @@ class NodeHandler {
         throw new Error("[node-red-sacn] None or invalid mode selected.");
     }
 
+    // a socket error (bind failure, multicast membership, …) is emitted as an
+    // "error" event; without a listener Node.js would treat it as an uncaught
+    // exception and could take the whole runtime down. Log it and surface it on
+    // the node instead, and keep running so the rest of the flow is unaffected.
+    this.sACN.on("error", (err: Error) => {
+      this.node.error(err);
+      this.node.status({ fill: "red", shape: "dot", text: err.message || "receiver error" });
+    });
+
     // run cleanup when node is closed
     this.node.on("close", () => {
       // close all connections; terminate the receiver
diff --git a/src/nodes/sacn-out/sacn-out.ts b/src/nodes/sacn-out/sacn-out.ts
index 13e0781..690894a 100644
--- a/src/nodes/sacn-out/sacn-out.ts
+++ b/src/nodes/sacn-out/sacn-out.ts
@@ -54,6 +54,14 @@ class NodeHandler {
 
     this.sACN = new Sender(this.options);
 
+    // a socket error is emitted as an "error" event; without a listener Node.js
+    // would treat it as an uncaught exception and could take the whole runtime
+    // down. Log it and surface it on the node instead, without throwing.
+    this.sACN.on("error", (err: Error) => {
+      this.node.error(err);
+      this.node.status({ fill: "red", shape: "dot", text: err.message || "sender error" });
+    });
+
     this.node.on("close", () => {
       // close all connections; terminate the receiver
       this.sACN.close();

From 4be255e0cebb3144b2876de3645700403db4e2a3 Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 09:50:49 +0200
Subject: [PATCH 04/22] Show the sending status on the sACN out node

The output node gave no feedback at all about what it was doing. Display a
node status with the configured universe and refresh rate so it is obvious
at a glance that the sender is configured and active.
---
 dist/nodes/sacn-out/sacn-out.js |  9 +++++++++
 src/nodes/sacn-out/sacn-out.ts  | 12 ++++++++++++
 2 files changed, 21 insertions(+)

diff --git a/dist/nodes/sacn-out/sacn-out.js b/dist/nodes/sacn-out/sacn-out.js
index 4bc59f4..b382c9a 100644
--- a/dist/nodes/sacn-out/sacn-out.js
+++ b/dist/nodes/sacn-out/sacn-out.js
@@ -38,6 +38,15 @@ class NodeHandler {
                 priority: config.priority || 100,
             });
         });
+        this.setStatus();
+    }
+    setStatus() {
+        const rate = this.config.speed !== undefined && this.config.speed > 0 ? `${this.config.speed} Hz` : "once";
+        this.node.status({
+            fill: "green",
+            shape: "dot",
+            text: `Universe ${this.config.universe} · ${rate}`,
+        });
     }
 }
 exports.default = (RED) => {
diff --git a/src/nodes/sacn-out/sacn-out.ts b/src/nodes/sacn-out/sacn-out.ts
index 690894a..0bb3d8e 100644
--- a/src/nodes/sacn-out/sacn-out.ts
+++ b/src/nodes/sacn-out/sacn-out.ts
@@ -74,6 +74,18 @@ class NodeHandler {
         priority: config.priority || 100,
       });
     });
+
+    this.setStatus();
+  }
+
+  protected setStatus(): void {
+    const rate = this.config.speed !== undefined && this.config.speed > 0 ? `${this.config.speed} Hz` : "once";
+
+    this.node.status({
+      fill: "green",
+      shape: "dot",
+      text: `Universe ${this.config.universe} · ${rate}`,
+    });
   }
 }
 

From a7e165d7d29babfd2c9c2a14d72c2a872676dd6a Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 09:51:23 +0200
Subject: [PATCH 05/22] Catch send failures on the sACN out node

The send promise was discarded with void, so a rejected send became an
unhandled promise rejection which can terminate the process. Handle the
result instead: reaffirm the status on success and log the error plus show
a red status on failure.
---
 dist/nodes/sacn-out/sacn-out.js | 10 +++++++++-
 src/nodes/sacn-out/sacn-out.ts  | 20 +++++++++++++++-----
 2 files changed, 24 insertions(+), 6 deletions(-)

diff --git a/dist/nodes/sacn-out/sacn-out.js b/dist/nodes/sacn-out/sacn-out.js
index b382c9a..9a9b690 100644
--- a/dist/nodes/sacn-out/sacn-out.js
+++ b/dist/nodes/sacn-out/sacn-out.js
@@ -32,10 +32,18 @@ class NodeHandler {
             this.sACN.close();
         });
         this.node.on("input", (msg) => {
-            void this.sACN.send({
+            this.sACN
+                .send({
                 payload: msg.payload,
                 sourceName: config.sourceName,
                 priority: config.priority || 100,
+            })
+                .then(() => {
+                this.setStatus();
+            })
+                .catch((err) => {
+                this.node.error(err, msg);
+                this.node.status({ fill: "red", shape: "dot", text: err.message || "send failed" });
             });
         });
         this.setStatus();
diff --git a/src/nodes/sacn-out/sacn-out.ts b/src/nodes/sacn-out/sacn-out.ts
index 0bb3d8e..6f642be 100644
--- a/src/nodes/sacn-out/sacn-out.ts
+++ b/src/nodes/sacn-out/sacn-out.ts
@@ -68,11 +68,21 @@ class NodeHandler {
     });
 
     this.node.on("input", (msg) => {
-      void this.sACN.send({
-        payload: msg.payload as number[],
-        sourceName: config.sourceName,
-        priority: config.priority || 100,
-      });
+      this.sACN
+        .send({
+          payload: msg.payload as number[],
+          sourceName: config.sourceName,
+          priority: config.priority || 100,
+        })
+        .then(() => {
+          this.setStatus();
+        })
+        .catch((err: Error) => {
+          // a failed send rejects the promise; handle it so it does not become
+          // an unhandled rejection (which would terminate the process)
+          this.node.error(err, msg);
+          this.node.status({ fill: "red", shape: "dot", text: err.message || "send failed" });
+        });
     });
 
     this.setStatus();

From 4a6234522221d8df432626343bd3f3756ad52bae Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 09:51:43 +0200
Subject: [PATCH 06/22] Use the official E1.31 universe range in the scene
 controller

The scene controller accepted universes up to 65279 while the receiver
node uses the E1.31 usable range of 1 to 63999. Align the scene controller
on 1 to 63999 so the whole package validates universes consistently.
---
 dist/nodes/scene-controller/scene-controller.js | 4 ++--
 src/nodes/scene-controller/scene-controller.ts  | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/dist/nodes/scene-controller/scene-controller.js b/dist/nodes/scene-controller/scene-controller.js
index 3646cab..c3bcb71 100644
--- a/dist/nodes/scene-controller/scene-controller.js
+++ b/dist/nodes/scene-controller/scene-controller.js
@@ -35,8 +35,8 @@ class NodeHandler {
         });
     }
     validateUniverse(universe) {
-        if (universe === undefined || isNaN(universe) || universe < 1 || universe > 65279) {
-            throw new Error(`The universe number '${universe}' (${typeof universe}) is invalid or not between 1 and 65279.`);
+        if (universe === undefined || isNaN(universe) || universe < 1 || universe > 63999) {
+            throw new Error(`The universe number '${universe}' (${typeof universe}) is invalid or not between 1 and 63999.`);
         }
     }
     validateChannel(channel, universe, firstChannel = 1, lastChannel = 512) {
diff --git a/src/nodes/scene-controller/scene-controller.ts b/src/nodes/scene-controller/scene-controller.ts
index 2246c70..6e0afbb 100644
--- a/src/nodes/scene-controller/scene-controller.ts
+++ b/src/nodes/scene-controller/scene-controller.ts
@@ -84,8 +84,8 @@ class NodeHandler {
   }
 
   protected validateUniverse(universe: number | undefined): void {
-    if (universe === undefined || isNaN(universe) || universe < 1 || universe > 65279) {
-      throw new Error(`The universe number '${universe}' (${typeof universe}) is invalid or not between 1 and 65279.`);
+    if (universe === undefined || isNaN(universe) || universe < 1 || universe > 63999) {
+      throw new Error(`The universe number '${universe}' (${typeof universe}) is invalid or not between 1 and 63999.`);
     }
   }
 

From 1c3a8f8d8a5b394a9660e69da9a2fe28e09222fa Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 09:52:46 +0200
Subject: [PATCH 07/22] Give the in and out nodes meaningful default labels
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Both editor definitions defaulted the node name to "Scene-Controller", so a
freshly dropped sACN in or sACN out node showed the wrong label on the
canvas. Clear the default name and fall back to a short type-and-universe
label ("sACN in · U1") when the user has not set a custom name.
---
 dist/nodes/sacn-in/sacn-in.html   | 4 ++--
 dist/nodes/sacn-out/sacn-out.html | 4 ++--
 src/nodes/sacn-in/init.ts         | 4 ++--
 src/nodes/sacn-out/init.ts        | 4 ++--
 4 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/dist/nodes/sacn-in/sacn-in.html b/dist/nodes/sacn-in/sacn-in.html
index 5f684c4..0da8b71 100644
--- a/dist/nodes/sacn-in/sacn-in.html
+++ b/dist/nodes/sacn-in/sacn-in.html
@@ -163,7 +163,7 @@ <h3>References</h3>
         color: "#dcc515",
         defaults: {
             name: {
-                value: "Scene-Controller",
+                value: "",
             },
             universe: {
                 value: 1,
@@ -202,7 +202,7 @@ <h3>References</h3>
         paletteLabel: "sACN in",
         icon: "font-awesome/fa-lightbulb-o",
         label: function () {
-            return this.name || "sACN";
+            return this.name || `sACN in · U${this.universe}`;
         },
         labelStyle: function () {
             return this.name ? "node_label_italic" : "";
diff --git a/dist/nodes/sacn-out/sacn-out.html b/dist/nodes/sacn-out/sacn-out.html
index 4806009..ac1c05f 100644
--- a/dist/nodes/sacn-out/sacn-out.html
+++ b/dist/nodes/sacn-out/sacn-out.html
@@ -99,7 +99,7 @@ <h3>References</h3>
         color: "#dcc515",
         defaults: {
             name: {
-                value: "Scene-Controller",
+                value: "",
             },
             universe: {
                 value: 1,
@@ -131,7 +131,7 @@ <h3>References</h3>
         paletteLabel: "sACN out",
         icon: "font-awesome/fa-lightbulb-o",
         label: function () {
-            return this.name || "sACN";
+            return this.name || `sACN out · U${this.universe}`;
         },
         labelStyle: function () {
             return this.name ? "node_label_italic" : "";
diff --git a/src/nodes/sacn-in/init.ts b/src/nodes/sacn-in/init.ts
index 421a140..679865a 100644
--- a/src/nodes/sacn-in/init.ts
+++ b/src/nodes/sacn-in/init.ts
@@ -18,7 +18,7 @@ const def: EditorNodeDef<Defaults> = {
   color: "#dcc515",
   defaults: {
     name: {
-      value: "Scene-Controller",
+      value: "",
     },
     universe: {
       value: 1,
@@ -57,7 +57,7 @@ const def: EditorNodeDef<Defaults> = {
   paletteLabel: "sACN in",
   icon: "font-awesome/fa-lightbulb-o",
   label: function () {
-    return this.name || "sACN";
+    return this.name || `sACN in · U${this.universe}`;
   },
   labelStyle: function () {
     return this.name ? "node_label_italic" : "";
diff --git a/src/nodes/sacn-out/init.ts b/src/nodes/sacn-out/init.ts
index b3e6d44..2f2d477 100644
--- a/src/nodes/sacn-out/init.ts
+++ b/src/nodes/sacn-out/init.ts
@@ -16,7 +16,7 @@ const def: EditorNodeDef<Defaults> = {
   color: "#dcc515",
   defaults: {
     name: {
-      value: "Scene-Controller",
+      value: "",
     },
     universe: {
       value: 1,
@@ -48,7 +48,7 @@ const def: EditorNodeDef<Defaults> = {
   paletteLabel: "sACN out",
   icon: "font-awesome/fa-lightbulb-o",
   label: function () {
-    return this.name || "sACN";
+    return this.name || `sACN out · U${this.universe}`;
   },
   labelStyle: function () {
     return this.name ? "node_label_italic" : "";

From c5756016b503c145628e403286958b401e14cd68 Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 09:53:22 +0200
Subject: [PATCH 08/22] Align the sACN in form defaults with the node
 definition

The universe field was a text input carrying numeric min/max/step
attributes that a text input ignores; make it a number input like the out
node. The mode dropdown pre-selected passthrough while the node default is
htp; mark htp as the selected option so the form matches the actual default.
---
 dist/nodes/sacn-in/sacn-in.html | 6 +++---
 src/nodes/sacn-in/form.html     | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/dist/nodes/sacn-in/sacn-in.html b/dist/nodes/sacn-in/sacn-in.html
index 0da8b71..b8ed902 100644
--- a/dist/nodes/sacn-in/sacn-in.html
+++ b/dist/nodes/sacn-in/sacn-in.html
@@ -11,7 +11,7 @@
             <i class="fa fa-hashtag"></i>
             <span data-i18n="sacn-in.label.universe"></span>
         </label>
-        <input type="text" id="node-input-universe" min="1" max="63999" step="1" style="width:70%;"/>
+        <input type="number" id="node-input-universe" min="1" max="63999" step="1" style="width:70%;"/>
     </div>
     <div class="form-row">
         <label for="node-input-mode">
@@ -19,8 +19,8 @@
             <span data-i18n="sacn-in.label.mode"></span>
         </label>
         <select id="node-input-mode" style="width:70%;">
-            <option value="passthrough" selected data-i18n="sacn-in.label.mode_direct"></option>
-            <option value="htp" data-i18n="sacn-in.label.mode_htp"></option>
+            <option value="passthrough" data-i18n="sacn-in.label.mode_direct"></option>
+            <option value="htp" selected data-i18n="sacn-in.label.mode_htp"></option>
             <option value="ltp" data-i18n="sacn-in.label.mode_ltp"></option>
         </select>
     </div>
diff --git a/src/nodes/sacn-in/form.html b/src/nodes/sacn-in/form.html
index 703afe8..22ae5a5 100644
--- a/src/nodes/sacn-in/form.html
+++ b/src/nodes/sacn-in/form.html
@@ -11,7 +11,7 @@
         <i class="fa fa-hashtag"></i>
         <span data-i18n="sacn-in.label.universe"></span>
     </label>
-    <input type="text" id="node-input-universe" min="1" max="63999" step="1" style="width:70%;"/>
+    <input type="number" id="node-input-universe" min="1" max="63999" step="1" style="width:70%;"/>
 </div>
 <div class="form-row">
     <label for="node-input-mode">
@@ -19,8 +19,8 @@
         <span data-i18n="sacn-in.label.mode"></span>
     </label>
     <select id="node-input-mode" style="width:70%;">
-        <option value="passthrough" selected data-i18n="sacn-in.label.mode_direct"></option>
-        <option value="htp" data-i18n="sacn-in.label.mode_htp"></option>
+        <option value="passthrough" data-i18n="sacn-in.label.mode_direct"></option>
+        <option value="htp" selected data-i18n="sacn-in.label.mode_htp"></option>
         <option value="ltp" data-i18n="sacn-in.label.mode_ltp"></option>
     </select>
 </div>

From 22450dc94226f2edb1e660171e6624120723c66a Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 09:53:42 +0200
Subject: [PATCH 09/22] Install dependencies with npm ci in the CI workflows

The code-style and TypeScript workflows used npm install, which can resolve
different versions than the lockfile. Switch them to npm ci for reproducible
installs from package-lock.json.
---
 .github/workflows/codestyle.yml  | 2 +-
 .github/workflows/typescript.yml | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/codestyle.yml b/.github/workflows/codestyle.yml
index 20ef136..5a545f6 100644
--- a/.github/workflows/codestyle.yml
+++ b/.github/workflows/codestyle.yml
@@ -20,7 +20,7 @@ jobs:
         with:
           node-version: "24"
           cache: "npm"
-      - run: npm install
+      - run: npm ci
       - name: Run prettier
         run: |
           shopt -s globstar
diff --git a/.github/workflows/typescript.yml b/.github/workflows/typescript.yml
index d77aa24..08a691d 100644
--- a/.github/workflows/typescript.yml
+++ b/.github/workflows/typescript.yml
@@ -27,7 +27,7 @@ jobs:
         with:
           node-version: ${{ matrix.node-version }}
           cache: "npm"
-      - run: npm install
+      - run: npm ci
       - run: |
           npx tsc --noEmit
   eslint:
@@ -40,5 +40,5 @@ jobs:
         with:
           node-version: "24"
           cache: "npm"
-      - run: npm install
+      - run: npm ci
       - run: npx eslint .

From 47f15e9a0a75a994abcfc150fade72fb41b4b7af Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 09:54:22 +0200
Subject: [PATCH 10/22] Gate the release on quality checks and pin the JSON
 action

Add type-check, lint and build steps before publishing so a broken build
can never be released, and pin the third-party github-action-json action to
a specific commit instead of a moving main ref to remove that supply-chain
risk.
---
 .github/workflows/release.yml | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 1d12715..aa0db0e 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -19,9 +19,16 @@ jobs:
           node-version: "24"
           registry-url: "https://registry.npmjs.com/"
       - run: npm ci
+      - name: Type-check
+        run: npx tsc --noEmit
+      - name: Lint
+        run: npx eslint .
+      - name: Build
+        run: npm run build
       - name: Read package.json
         id: package
-        uses: RadovanPelka/github-action-json@main
+        # pinned to a commit to avoid pulling an unreviewed moving ref
+        uses: RadovanPelka/github-action-json@c1e93581d313d6e1d56f7f67582d4051674ebc57 # main
         with:
           path: "package.json"
       - name: Remove old builds

From 434e5e4c70b27b500b99affd7c9eac6a5abc4209 Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 09:55:04 +0200
Subject: [PATCH 11/22] Fix spelling mistakes in the readme and out node label

Correct "Paremeter", "wether" and "send by sACN" in the readme and the
"IP-addresse" label of the out node.
---
 README.md                                       | 10 +++++-----
 dist/nodes/sacn-out/locales/en-US/sacn-out.json |  2 +-
 src/nodes/sacn-out/locales/en-US.json           |  2 +-
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index e85b974..f91ebdf 100644
--- a/README.md
+++ b/README.md
@@ -25,15 +25,15 @@ Copyright MysteryCode and other contributors under [GNU GENERAL PUBLIC LICENSE V
 
 ### sACN in
 
-This node can be used to read one or multiple universes send by sACN.
+This node can be used to read one or multiple universes sent by sACN.
 
 #### Parameters:
 
-| Paremeter  | Description                                                                                                                   | Possible Values                                                | Default Value                | Mandatory |
+| Parameter  | Description                                                                                                                   | Possible Values                                                | Default Value                | Mandatory |
 | ---------- | ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | ---------------------------- | --------- |
 | universe   | The universe that is meant to be observed.                                                                                    | `\d+` (`1` to `63999`)                                         | `1`                          | yes       |
 | mode       | Defines whether the node returns the values of every read sACN package (passthrough mode), or merged values using HTP or LTP. | `passthrough`, `htp`, `ltp`                                    | `htp`                        | yes       |
-| output     | Defines wether the node sends only changed values or the whole universe.                                                      | `full`, `changes`                                              | `full`                       | yes       |
+| output     | Defines whether the node sends only changed values or the whole universe.                                                      | `full`, `changes`                                              | `full`                       | yes       |
 | IP-address | IP-Address of the network-interface that should be used for reading from sACN.                                                | `\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\` (_any valid ip-address_) | _empty_                      | no        |
 | port       | The network port which should be used for reading sACN.                                                                       | `\d+`                                                          | _empty_ (defaults to `5568`) | no        |
 
@@ -60,7 +60,7 @@ This node can be used to send one universe using sACN.
 
 #### Parameters:
 
-| Paremeter   | Description                                                               | Possible Values                                                | Default Value                | Mandatory |
+| Parameter   | Description                                                               | Possible Values                                                | Default Value                | Mandatory |
 | ----------- | ------------------------------------------------------------------------- | -------------------------------------------------------------- | ---------------------------- | --------- |
 | universe    | The universe that is meant to be observed.                                | `\d+` (`1` to `63999`)                                         | `1`                          | yes       |
 | source-name | The name for the sACN-sender that should be displayed within the network. | _any string below 50 characters_                               | `Node-RED`                   | yes       |
@@ -81,7 +81,7 @@ This node can be used to record scenes and play them afterwards.
 
 #### Parameters:
 
-| Paremeter | Description | Possible Values | Default Value | Mandatory |
+| Parameter | Description | Possible Values | Default Value | Mandatory |
 | --------- | ----------- | --------------- | ------------- | --------- |
 
 #### Expected input:
diff --git a/dist/nodes/sacn-out/locales/en-US/sacn-out.json b/dist/nodes/sacn-out/locales/en-US/sacn-out.json
index 367be4b..94a7893 100644
--- a/dist/nodes/sacn-out/locales/en-US/sacn-out.json
+++ b/dist/nodes/sacn-out/locales/en-US/sacn-out.json
@@ -1,7 +1,7 @@
 {
   "sacn-out": {
     "label": {
-      "interface": "IP-addresse of interface",
+      "interface": "IP-address of interface",
       "port": "port",
       "priority": "priority",
       "sourceName": "source-name",
diff --git a/src/nodes/sacn-out/locales/en-US.json b/src/nodes/sacn-out/locales/en-US.json
index 29db413..fca3dbb 100644
--- a/src/nodes/sacn-out/locales/en-US.json
+++ b/src/nodes/sacn-out/locales/en-US.json
@@ -1,6 +1,6 @@
 {
   "label": {
-    "interface": "IP-addresse of interface",
+    "interface": "IP-address of interface",
     "port": "port",
     "priority": "priority",
     "sourceName": "source-name",

From f2959c93cef464fd639dabf7ef228c8b5568c981 Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 09:56:22 +0200
Subject: [PATCH 12/22] Document the new receiver options and runtime universe
 switch

Add the output trigger, keepalive interval and blank-on-universe-change
options to the sACN in parameter table, describe switching the observed
universe at runtime via a message, note the Node-RED and Node.js version
requirements, and correct the scene controller sections (empty parameter
table and the universe input, which is only required for a single universe).
---
 README.md | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index f91ebdf..e7e0f7e 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,8 @@ for [Node-RED](https://nodered.org).
 
 ## Requirements
 
-Required version of Node-RED: v4.0.5
+- Node-RED `>= 4.0.0`
+- Node.js `>= 24.0.0`
 
 This package requires [`sacn`](https://www.npmjs.com/package/sacn) as library to interact by sACN.
 
@@ -34,9 +35,16 @@ This node can be used to read one or multiple universes sent by sACN.
 | universe   | The universe that is meant to be observed.                                                                                    | `\d+` (`1` to `63999`)                                         | `1`                          | yes       |
 | mode       | Defines whether the node returns the values of every read sACN package (passthrough mode), or merged values using HTP or LTP. | `passthrough`, `htp`, `ltp`                                    | `htp`                        | yes       |
 | output     | Defines whether the node sends only changed values or the whole universe.                                                      | `full`, `changes`                                              | `full`                       | yes       |
+| trigger    | Controls when a message is emitted: only on change, on every received packet, or on change plus a cyclic keepalive re-emit.    | `changes`, `always`, `interval`                                | `changes`                    | yes       |
+| interval   | Keepalive interval in milliseconds for the `interval` trigger; the full universe is re-emitted when no change arrives in time. | `\d+`                                                          | `1000`                       | no        |
+| clearOnUniverseChange | When the observed universe is switched at runtime, emit a full universe of zeros until real data for the new universe arrives. | `true`, `false`                                     | `false`                      | no        |
 | IP-address | IP-Address of the network-interface that should be used for reading from sACN.                                                | `\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\` (_any valid ip-address_) | _empty_                      | no        |
 | port       | The network port which should be used for reading sACN.                                                                       | `\d+`                                                          | _empty_ (defaults to `5568`) | no        |
 
+#### Input:
+
+The observed universe can be switched at runtime by sending a message with a `universe` property (`1` to `63999`). The node stops listening on the previous universe and starts listening on the new one; invalid values are ignored and produce a warning.
+
 #### Output for direct-mode:
 
 | Property   | Description                                                                                                                               |
@@ -81,8 +89,7 @@ This node can be used to record scenes and play them afterwards.
 
 #### Parameters:
 
-| Parameter | Description | Possible Values | Default Value | Mandatory |
-| --------- | ----------- | --------------- | ------------- | --------- |
+This node has no configuration parameters; its behaviour is controlled entirely through the incoming message.
 
 #### Expected input:
 
@@ -90,7 +97,7 @@ This node can be used to record scenes and play them afterwards.
 | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------- |
 | `action`   | the action to be executed - `save` to save a preset, `play` to play a saved preset, `reset` to reset                                                                                                                                                                                 | yes                             |
 | `scene`    | for action                                                                                                                                                                                                                                                                           | yes, for actions `save`, `play` |
-| `universe` | if only one universe is handled, this parameter is mandatory and contains the used universe                                                                                                                                                                                          | yes                             |
+| `universe` | if only one universe is handled, this parameter is mandatory and contains the used universe                                                                                                                                                                                          | only for a single universe      |
 | `payload`  | contains the values to record. it might be an array (key 0-511) containing the values for a single universe,<br/>an object (keys 1-512) containing the values for a single universe or<br/>an object (any numeric keys) containing objects (keys 1-512) containing an universe each. | yes, for action `save`          |
 
 #### Output for single universe:

From 1549dac9dcd073f935abb21ce6bdf5cf929813c2 Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 09:57:10 +0200
Subject: [PATCH 13/22] Document the protocol limitations in the readme

Add a section spelling out what the underlying library does not provide:
no universe discovery, no synchronization, no stream termination on stop,
and DMX values represented as percentages rather than raw 8-bit values, so
integrators can judge compatibility up front.
---
 README.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/README.md b/README.md
index e7e0f7e..116a540 100644
--- a/README.md
+++ b/README.md
@@ -117,3 +117,12 @@ This node has no configuration parameters; its behaviour is controlled entirely
 | `payload`  | Object containing one object per universe. DMX-Channel `1` starts at key `1`, not `0`. (`object<number, object<number, number>>`) |
 | `scene`    | The scene that is played (`number`)                                                                                               |
 | `reset`    | Identifies a reset message for action `reset`, otherwise it does not exist. (`true`)                                              |
+
+## Protocol notes and limitations
+
+This package builds on the [`sacn`](https://www.npmjs.com/package/sacn) library and inherits its scope. Be aware of the following when integrating it:
+
+- **No Universe Discovery.** The sender does not emit E1.31 Universe Discovery packets, so receivers relying on discovery will not see this source listed automatically.
+- **No synchronization.** E1.31 universe synchronization (synchronized multi-universe updates) is not implemented.
+- **No stream termination.** When a sender node is stopped or redeployed it simply closes its socket; it does not send packets with the `Stream_Terminated` flag. Receivers therefore hold the last received values until their own signal-loss timeout (typically ~2.5 s) elapses.
+- **DMX values are percentages.** Channel values are expressed as a percentage (`0`–`100`, with up to two decimals) rather than as raw 8-bit values (`0`–`255`).

From 78df22e58f799a44441fb924c1f7781189896784 Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 09:57:29 +0200
Subject: [PATCH 14/22] Add safety and legal notices to the readme

Spell out that this is not a certified safety system and must not be used
for emergency lighting or the functional safety of machinery, and add
notices for strobe/photosensitivity and laser control, with the relevant
DE/AT/CH frameworks so operators know where responsibility lies.
---
 README.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/README.md b/README.md
index 116a540..847b808 100644
--- a/README.md
+++ b/README.md
@@ -126,3 +126,14 @@ This package builds on the [`sacn`](https://www.npmjs.com/package/sacn) library
 - **No synchronization.** E1.31 universe synchronization (synchronized multi-universe updates) is not implemented.
 - **No stream termination.** When a sender node is stopped or redeployed it simply closes its socket; it does not send packets with the `Stream_Terminated` flag. Receivers therefore hold the last received values until their own signal-loss timeout (typically ~2.5 s) elapses.
 - **DMX values are percentages.** Channel values are expressed as a percentage (`0`–`100`, with up to two decimals) rather than as raw 8-bit values (`0`–`255`).
+
+## Safety and legal notice
+
+This package is network/protocol software for controlling DMX/sACN lighting. It is **not** a certified safety system, and sACN (E1.31) is an unauthenticated, best-effort protocol with no delivery guarantees. Operate it on a dedicated, segmented lighting network. Please observe the following before deploying it:
+
+- **No safety or emergency lighting.** Do not use this package to control safety, escape-route or emergency lighting. Such installations require certified, monitored systems (e.g. DE: DIN VDE 0108-100, DIN EN 1838; AT: TRVB E 102, ÖVE/ÖNORM E 8002; CH: SN EN 1838 and the VKF fire-protection guidelines).
+- **No functional machine safety.** sACN/DMX is not a safety bus. Do not use it for the functional safety of machinery, kinetics, hoists or moving stage equipment (cf. Machinery Directive 2006/42/EC / Regulation (EU) 2023/1230, DIN 56950, EN ISO 13849, DGUV V3).
+- **Strobe / photosensitivity.** The software can drive arbitrary strobe and flashing effects. Operators are responsible for protecting audiences and staff from photosensitive-epilepsy and glare hazards (e.g. DE: VStättVO, DGUV Information 215-313).
+- **Lasers.** If DMX is used to control laser sources, the applicable laser-safety rules apply (e.g. DIN EN 60825; DE: OStrV / TROS Laserstrahlung, incl. an appointed laser safety officer).
+
+This is not legal advice. Responsibility for compliance, CE conformity of the controlled hardware and safe operation rests with the integrator and operator.

From 0514703d1cd7b6c6720a21d76be6ea9cbc4f4b41 Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 10:08:30 +0200
Subject: [PATCH 15/22] Add an option to blank the sACN out universe on stop

sACN has no stream-termination handling here, so on stop or redeploy
receivers held the last look until their own signal-loss timeout. Add an
opt-in setting that sends an all-zero frame before the socket is closed, so
the output can be defined to go dark on shutdown.
---
 dist/nodes/sacn-out/locales/de/sacn-out.json  |  3 +-
 .../sacn-out/locales/en-US/sacn-out.json      |  3 +-
 dist/nodes/sacn-out/sacn-out.html             | 10 +++++
 dist/nodes/sacn-out/sacn-out.js               | 27 ++++++++++++-
 src/nodes/sacn-out/form.html                  |  7 ++++
 src/nodes/sacn-out/init.ts                    |  4 ++
 src/nodes/sacn-out/locales/de.json            |  3 +-
 src/nodes/sacn-out/locales/en-US.json         |  3 +-
 src/nodes/sacn-out/sacn-out.ts                | 38 +++++++++++++++++--
 9 files changed, 89 insertions(+), 9 deletions(-)

diff --git a/dist/nodes/sacn-out/locales/de/sacn-out.json b/dist/nodes/sacn-out/locales/de/sacn-out.json
index 23e4e70..48122d2 100644
--- a/dist/nodes/sacn-out/locales/de/sacn-out.json
+++ b/dist/nodes/sacn-out/locales/de/sacn-out.json
@@ -12,7 +12,8 @@
       "speed_40": "Hoch (40Hz)",
       "speed_44": "Maximum (44Hz)",
       "speed_once": "Einmalig (0Hz)",
-      "universe": "Universum"
+      "universe": "Universum",
+      "blankOnClose": "Ausgabe beim Stoppen auf 0 setzen"
     }
   }
 }
\ No newline at end of file
diff --git a/dist/nodes/sacn-out/locales/en-US/sacn-out.json b/dist/nodes/sacn-out/locales/en-US/sacn-out.json
index 94a7893..34b357d 100644
--- a/dist/nodes/sacn-out/locales/en-US/sacn-out.json
+++ b/dist/nodes/sacn-out/locales/en-US/sacn-out.json
@@ -12,7 +12,8 @@
       "speed_40": "high (40Hz)",
       "speed_44": "maximum (44Hz)",
       "speed_once": "once (0Hz)",
-      "universe": "universe"
+      "universe": "universe",
+      "blankOnClose": "blank output on stop"
     }
   }
 }
\ No newline at end of file
diff --git a/dist/nodes/sacn-out/sacn-out.html b/dist/nodes/sacn-out/sacn-out.html
index ac1c05f..a19cf57 100644
--- a/dist/nodes/sacn-out/sacn-out.html
+++ b/dist/nodes/sacn-out/sacn-out.html
@@ -41,6 +41,13 @@
         </label>
         <input type="number" id="node-input-priority" min="1" max="200" step="1" style="width:70%;"/>
     </div>
+    <div class="form-row">
+        <label for="node-input-blankOnClose" style="width:auto;">
+            <i class="fa fa-eraser"></i>
+            <span data-i18n="sacn-out.label.blankOnClose"></span>
+        </label>
+        <input type="checkbox" id="node-input-blankOnClose" style="display:inline-block; width:auto; vertical-align:top; margin-left:4px;"/>
+    </div>
     <div class="form-row">
         <label for="node-input-interface">
             <i class="fa fa-plug"></i>
@@ -125,6 +132,9 @@ <h3>References</h3>
                 value: "Node-RED",
                 required: true,
             },
+            blankOnClose: {
+                value: false,
+            },
         },
         inputs: 1,
         outputs: 0,
diff --git a/dist/nodes/sacn-out/sacn-out.js b/dist/nodes/sacn-out/sacn-out.js
index 9a9b690..162b0b8 100644
--- a/dist/nodes/sacn-out/sacn-out.js
+++ b/dist/nodes/sacn-out/sacn-out.js
@@ -28,8 +28,24 @@ class NodeHandler {
             this.node.error(err);
             this.node.status({ fill: "red", shape: "dot", text: err.message || "sender error" });
         });
-        this.node.on("close", () => {
-            this.sACN.close();
+        this.node.on("close", (done) => {
+            const shutdown = () => {
+                this.sACN.close();
+                done();
+            };
+            if (this.config.blankOnClose) {
+                this.sACN
+                    .send({
+                    payload: this.getBlankPayload(),
+                    sourceName: config.sourceName,
+                    priority: config.priority || 100,
+                })
+                    .then(shutdown)
+                    .catch(shutdown);
+            }
+            else {
+                shutdown();
+            }
         });
         this.node.on("input", (msg) => {
             this.sACN
@@ -48,6 +64,13 @@ class NodeHandler {
         });
         this.setStatus();
     }
+    getBlankPayload() {
+        const payload = {};
+        for (let ch = 1; ch <= 512; ch++) {
+            payload[ch] = 0;
+        }
+        return payload;
+    }
     setStatus() {
         const rate = this.config.speed !== undefined && this.config.speed > 0 ? `${this.config.speed} Hz` : "once";
         this.node.status({
diff --git a/src/nodes/sacn-out/form.html b/src/nodes/sacn-out/form.html
index c772503..a6b1f93 100644
--- a/src/nodes/sacn-out/form.html
+++ b/src/nodes/sacn-out/form.html
@@ -41,6 +41,13 @@
     </label>
     <input type="number" id="node-input-priority" min="1" max="200" step="1" style="width:70%;"/>
 </div>
+<div class="form-row">
+    <label for="node-input-blankOnClose" style="width:auto;">
+        <i class="fa fa-eraser"></i>
+        <span data-i18n="sacn-out.label.blankOnClose"></span>
+    </label>
+    <input type="checkbox" id="node-input-blankOnClose" style="display:inline-block; width:auto; vertical-align:top; margin-left:4px;"/>
+</div>
 <div class="form-row">
     <label for="node-input-interface">
         <i class="fa fa-plug"></i>
diff --git a/src/nodes/sacn-out/init.ts b/src/nodes/sacn-out/init.ts
index 2f2d477..d8f32b0 100644
--- a/src/nodes/sacn-out/init.ts
+++ b/src/nodes/sacn-out/init.ts
@@ -9,6 +9,7 @@ interface Defaults extends EditorNodeProperties {
   speed: number;
   priority: number;
   sourceName: string;
+  blankOnClose: boolean;
 }
 
 const def: EditorNodeDef<Defaults> = {
@@ -42,6 +43,9 @@ const def: EditorNodeDef<Defaults> = {
       value: "Node-RED",
       required: true,
     },
+    blankOnClose: {
+      value: false,
+    },
   },
   inputs: 1,
   outputs: 0,
diff --git a/src/nodes/sacn-out/locales/de.json b/src/nodes/sacn-out/locales/de.json
index 6f631a7..9ad54ae 100644
--- a/src/nodes/sacn-out/locales/de.json
+++ b/src/nodes/sacn-out/locales/de.json
@@ -11,6 +11,7 @@
     "speed_40": "Hoch (40Hz)",
     "speed_44": "Maximum (44Hz)",
     "speed_once": "Einmalig (0Hz)",
-    "universe": "Universum"
+    "universe": "Universum",
+    "blankOnClose": "Ausgabe beim Stoppen auf 0 setzen"
   }
 }
diff --git a/src/nodes/sacn-out/locales/en-US.json b/src/nodes/sacn-out/locales/en-US.json
index fca3dbb..b9ad716 100644
--- a/src/nodes/sacn-out/locales/en-US.json
+++ b/src/nodes/sacn-out/locales/en-US.json
@@ -11,6 +11,7 @@
     "speed_40": "high (40Hz)",
     "speed_44": "maximum (44Hz)",
     "speed_once": "once (0Hz)",
-    "universe": "universe"
+    "universe": "universe",
+    "blankOnClose": "blank output on stop"
   }
 }
diff --git a/src/nodes/sacn-out/sacn-out.ts b/src/nodes/sacn-out/sacn-out.ts
index 6f642be..85cfbdf 100644
--- a/src/nodes/sacn-out/sacn-out.ts
+++ b/src/nodes/sacn-out/sacn-out.ts
@@ -21,6 +21,11 @@ export interface Config extends NodeDef {
   sourceName: string;
   priority?: number;
   speed?: number;
+  blankOnClose?: boolean;
+}
+
+interface DMXValues {
+  [key: number]: number;
 }
 
 export type MessageIn = NodeMessage;
@@ -62,9 +67,27 @@ class NodeHandler {
       this.node.status({ fill: "red", shape: "dot", text: err.message || "sender error" });
     });
 
-    this.node.on("close", () => {
-      // close all connections; terminate the receiver
-      this.sACN.close();
+    this.node.on("close", (done: () => void) => {
+      const shutdown = (): void => {
+        // close all connections; terminate the sender
+        this.sACN.close();
+        done();
+      };
+
+      // optionally blank the universe (send all-zero values) before closing, so
+      // receivers do not hold the last look until their own signal-loss timeout
+      if (this.config.blankOnClose) {
+        this.sACN
+          .send({
+            payload: this.getBlankPayload(),
+            sourceName: config.sourceName,
+            priority: config.priority || 100,
+          })
+          .then(shutdown)
+          .catch(shutdown);
+      } else {
+        shutdown();
+      }
     });
 
     this.node.on("input", (msg) => {
@@ -88,6 +111,15 @@ class NodeHandler {
     this.setStatus();
   }
 
+  protected getBlankPayload(): DMXValues {
+    const payload: DMXValues = {};
+    for (let ch = 1; ch <= 512; ch++) {
+      payload[ch] = 0;
+    }
+
+    return payload;
+  }
+
   protected setStatus(): void {
     const rate = this.config.speed !== undefined && this.config.speed > 0 ? `${this.config.speed} Hz` : "once";
 

From a2970001c125d68b0601642922c9f63bd3ed0c37 Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 10:11:42 +0200
Subject: [PATCH 16/22] Extract shared DMX and network helpers to remove
 duplication

The zeroed-universe builder, the DMX value type and the interface/port
resolution were copied across the receiver, sender and scene controller.
Move them into a small shared backend library and use it from all three
nodes. Editor (frontend) code stays separate as it cannot share runtime
modules.
---
 dist/lib/dmx.js                               | 15 +++++++++
 dist/lib/network.js                           | 14 ++++++++
 dist/nodes/sacn-in/sacn-in.js                 | 27 +++++----------
 dist/nodes/sacn-out/sacn-out.js               | 23 ++++---------
 .../scene-controller/scene-controller.js      | 12 ++-----
 src/lib/dmx.ts                                | 21 ++++++++++++
 src/lib/network.ts                            | 25 ++++++++++++++
 src/nodes/sacn-in/sacn-in.ts                  | 33 +++++--------------
 src/nodes/sacn-out/sacn-out.ts                | 28 ++++------------
 .../scene-controller/scene-controller.ts      | 19 ++---------
 10 files changed, 113 insertions(+), 104 deletions(-)
 create mode 100644 dist/lib/dmx.js
 create mode 100644 dist/lib/network.js
 create mode 100644 src/lib/dmx.ts
 create mode 100644 src/lib/network.ts

diff --git a/dist/lib/dmx.js b/dist/lib/dmx.js
new file mode 100644
index 0000000..2947779
--- /dev/null
+++ b/dist/lib/dmx.js
@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LAST_UNIVERSE = exports.FIRST_UNIVERSE = exports.LAST_CHANNEL = exports.FIRST_CHANNEL = void 0;
+exports.nulledUniverse = nulledUniverse;
+exports.FIRST_CHANNEL = 1;
+exports.LAST_CHANNEL = 512;
+exports.FIRST_UNIVERSE = 1;
+exports.LAST_UNIVERSE = 63999;
+function nulledUniverse() {
+    const universe = {};
+    for (let channel = exports.FIRST_CHANNEL; channel <= exports.LAST_CHANNEL; channel++) {
+        universe[channel] = 0;
+    }
+    return universe;
+}
diff --git a/dist/lib/network.js b/dist/lib/network.js
new file mode 100644
index 0000000..0c013e4
--- /dev/null
+++ b/dist/lib/network.js
@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PORT = void 0;
+exports.resolveNetworkOptions = resolveNetworkOptions;
+exports.DEFAULT_PORT = 5568;
+function resolveNetworkOptions(config) {
+    const options = {
+        port: config.port !== undefined && config.port > 0 ? config.port : exports.DEFAULT_PORT,
+    };
+    if (config.interface !== undefined && config.interface.length > 7) {
+        options.iface = config.interface;
+    }
+    return options;
+}
diff --git a/dist/nodes/sacn-in/sacn-in.js b/dist/nodes/sacn-in/sacn-in.js
index 7b72fad..4249046 100644
--- a/dist/nodes/sacn-in/sacn-in.js
+++ b/dist/nodes/sacn-in/sacn-in.js
@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const sacn_1 = require("sacn");
+const dmx_1 = require("../../lib/dmx");
+const network_1 = require("../../lib/network");
 class NodeHandler {
     node;
     config;
@@ -16,18 +18,14 @@ class NodeHandler {
         this.currentUniverse = config.universe;
         this.trigger = config.trigger ?? (config.mode === "passthrough" ? "always" : "changes");
         this.interval = config.interval !== undefined && config.interval > 0 ? config.interval : 1000;
+        const network = (0, network_1.resolveNetworkOptions)(config);
         const options = {
             universes: [config.universe],
             reuseAddr: config.reuseAddress !== undefined ? config.reuseAddress : true,
+            port: network.port,
         };
-        if (config.interface !== undefined && config.interface.length > 7) {
-            options.iface = config.interface;
-        }
-        if (config.port !== undefined && config.port > 0) {
-            options.port = config.port;
-        }
-        else {
-            options.port = 5568;
+        if (network.iface !== undefined) {
+            options.iface = network.iface;
         }
         switch (config.mode) {
             case "passthrough":
@@ -117,23 +115,16 @@ class NodeHandler {
         this.currentUniverse = universe;
         this.setStatus();
         if (this.config.clearOnUniverseChange) {
-            this.data?.set(universe, this.getNulledUniverse());
+            this.data?.set(universe, (0, dmx_1.nulledUniverse)());
             this.emitFull(universe);
         }
         else {
             this.resetKeepalive();
         }
     }
-    getNulledUniverse() {
-        const universe = {};
-        for (let ch = 1; ch <= 512; ch++) {
-            universe[ch] = 0;
-        }
-        return universe;
-    }
     applyFrame(incoming, universe) {
         const previous = this.data?.get(universe);
-        const full = this.getNulledUniverse();
+        const full = (0, dmx_1.nulledUniverse)();
         Object.keys(incoming).forEach((key) => {
             const ch = parseInt(key, 10);
             if (ch >= 1 && ch <= 512) {
@@ -161,7 +152,7 @@ class NodeHandler {
         this.resetKeepalive();
     }
     emitFull(universe) {
-        const full = this.data?.get(universe) ?? this.getNulledUniverse();
+        const full = this.data?.get(universe) ?? (0, dmx_1.nulledUniverse)();
         this.sendData({ universe, payload: full });
     }
     resetKeepalive() {
diff --git a/dist/nodes/sacn-out/sacn-out.js b/dist/nodes/sacn-out/sacn-out.js
index 162b0b8..3476889 100644
--- a/dist/nodes/sacn-out/sacn-out.js
+++ b/dist/nodes/sacn-out/sacn-out.js
@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const sacn_1 = require("sacn");
+const dmx_1 = require("../../lib/dmx");
+const network_1 = require("../../lib/network");
 class NodeHandler {
     node;
     config;
@@ -9,19 +11,15 @@ class NodeHandler {
     constructor(node, config) {
         this.node = node;
         this.config = config;
+        const network = (0, network_1.resolveNetworkOptions)(config);
         this.options = {
             universe: config.universe,
             reuseAddr: config.reuseAddress !== undefined ? config.reuseAddress : true,
             minRefreshRate: config.speed !== undefined ? config.speed : 0,
+            port: network.port,
         };
-        if (config.interface !== undefined && config.interface.length > 7) {
-            this.options.iface = config.interface;
-        }
-        if (config.port !== undefined && config.port > 0) {
-            this.options.port = config.port;
-        }
-        else {
-            this.options.port = 5568;
+        if (network.iface !== undefined) {
+            this.options.iface = network.iface;
         }
         this.sACN = new sacn_1.Sender(this.options);
         this.sACN.on("error", (err) => {
@@ -36,7 +34,7 @@ class NodeHandler {
             if (this.config.blankOnClose) {
                 this.sACN
                     .send({
-                    payload: this.getBlankPayload(),
+                    payload: (0, dmx_1.nulledUniverse)(),
                     sourceName: config.sourceName,
                     priority: config.priority || 100,
                 })
@@ -64,13 +62,6 @@ class NodeHandler {
         });
         this.setStatus();
     }
-    getBlankPayload() {
-        const payload = {};
-        for (let ch = 1; ch <= 512; ch++) {
-            payload[ch] = 0;
-        }
-        return payload;
-    }
     setStatus() {
         const rate = this.config.speed !== undefined && this.config.speed > 0 ? `${this.config.speed} Hz` : "once";
         this.node.status({
diff --git a/dist/nodes/scene-controller/scene-controller.js b/dist/nodes/scene-controller/scene-controller.js
index c3bcb71..37cdb09 100644
--- a/dist/nodes/scene-controller/scene-controller.js
+++ b/dist/nodes/scene-controller/scene-controller.js
@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const dmx_1 = require("../../lib/dmx");
 class NodeHandler {
     node;
     config;
@@ -226,13 +227,6 @@ class NodeHandler {
             text: message.topic ?? `Scene ${message.scene}`,
         });
     }
-    getNulledUniverse() {
-        const universe = {};
-        for (let ch = 1; ch <= 512; ch++) {
-            universe[ch] = 0;
-        }
-        return universe;
-    }
     handleReset(message) {
         const resetScene = (scene) => {
             const data = this.node.context().get(`scene-${scene}`);
@@ -249,12 +243,12 @@ class NodeHandler {
                     let payload;
                     if (universes.length === 1) {
                         universe = parseInt(universes[0], 10);
-                        payload = this.getNulledUniverse();
+                        payload = (0, dmx_1.nulledUniverse)();
                     }
                     else {
                         payload = {};
                         universes.forEach((universe) => {
-                            payload[parseInt(universe, 10)] = this.getNulledUniverse();
+                            payload[parseInt(universe, 10)] = (0, dmx_1.nulledUniverse)();
                         });
                     }
                     const out = {
diff --git a/src/lib/dmx.ts b/src/lib/dmx.ts
new file mode 100644
index 0000000..36447da
--- /dev/null
+++ b/src/lib/dmx.ts
@@ -0,0 +1,21 @@
+export interface DMXValues {
+  [key: number]: number;
+}
+
+/** lowest and highest DMX channel within a universe */
+export const FIRST_CHANNEL = 1;
+export const LAST_CHANNEL = 512;
+
+/** usable sACN (E1.31) universe range */
+export const FIRST_UNIVERSE = 1;
+export const LAST_UNIVERSE = 63999;
+
+/** a full universe with every channel set to 0 */
+export function nulledUniverse(): DMXValues {
+  const universe: DMXValues = {};
+  for (let channel = FIRST_CHANNEL; channel <= LAST_CHANNEL; channel++) {
+    universe[channel] = 0;
+  }
+
+  return universe;
+}
diff --git a/src/lib/network.ts b/src/lib/network.ts
new file mode 100644
index 0000000..3fba3eb
--- /dev/null
+++ b/src/lib/network.ts
@@ -0,0 +1,25 @@
+export interface NetworkConfig {
+  interface?: string;
+  port?: number;
+}
+
+export interface NetworkOptions {
+  iface?: string;
+  port: number;
+}
+
+/** default sACN (E1.31) network port */
+export const DEFAULT_PORT = 5568;
+
+/** resolve the shared interface/port options for a receiver or sender */
+export function resolveNetworkOptions(config: NetworkConfig): NetworkOptions {
+  const options: NetworkOptions = {
+    port: config.port !== undefined && config.port > 0 ? config.port : DEFAULT_PORT,
+  };
+
+  if (config.interface !== undefined && config.interface.length > 7) {
+    options.iface = config.interface;
+  }
+
+  return options;
+}
diff --git a/src/nodes/sacn-in/sacn-in.ts b/src/nodes/sacn-in/sacn-in.ts
index 4ee0035..e649088 100644
--- a/src/nodes/sacn-in/sacn-in.ts
+++ b/src/nodes/sacn-in/sacn-in.ts
@@ -1,10 +1,8 @@
 import { Node, NodeAPI, NodeDef } from "node-red";
 import { NodeMessage } from "@node-red/registry";
 import { Packet, Receiver, unstable_MergingReceiver as MergingReceiver } from "sacn";
-
-interface DMXValues {
-  [key: number]: number | undefined;
-}
+import { DMXValues, nulledUniverse } from "../../lib/dmx";
+import { resolveNetworkOptions } from "../../lib/network";
 
 interface Config extends NodeDef {
   universe: number;
@@ -56,17 +54,14 @@ class NodeHandler {
     this.interval = config.interval !== undefined && config.interval > 0 ? config.interval : 1000;
 
     // parse options for receiver instance
+    const network = resolveNetworkOptions(config);
     const options: Receiver.Props | MergingReceiver.Props = {
       universes: [config.universe],
       reuseAddr: config.reuseAddress !== undefined ? config.reuseAddress : true,
+      port: network.port,
     };
-    if (config.interface !== undefined && config.interface.length > 7) {
-      options.iface = config.interface;
-    }
-    if (config.port !== undefined && config.port > 0) {
-      options.port = config.port;
-    } else {
-      options.port = 5568;
+    if (network.iface !== undefined) {
+      options.iface = network.iface;
     }
 
     // init sacn receiver
@@ -195,7 +190,7 @@ class NodeHandler {
 
     if (this.config.clearOnUniverseChange) {
       // emit a blanked universe until real data for the new universe arrives
-      this.data?.set(universe, this.getNulledUniverse());
+      this.data?.set(universe, nulledUniverse());
       this.emitFull(universe);
     } else {
       // keep the keepalive heartbeat aligned with the new universe
@@ -203,22 +198,12 @@ class NodeHandler {
     }
   }
 
-  protected getNulledUniverse(): DMXValues {
-    const universe: DMXValues = {};
-
-    for (let ch = 1; ch <= 512; ch++) {
-      universe[ch] = 0;
-    }
-
-    return universe;
-  }
-
   protected applyFrame(incoming: DMXValues, universe: number): { payload: DMXValues; changed: boolean } {
     // an sACN data packet always describes the complete universe; channels that are
     // absent from the received payload are deliberately 0, not unchanged. Rebuild the
     // full state from a zeroed base so a channel fading to 0 is reflected correctly.
     const previous = this.data?.get(universe);
-    const full = this.getNulledUniverse();
+    const full = nulledUniverse();
 
     Object.keys(incoming).forEach((key) => {
       const ch = parseInt(key, 10);
@@ -256,7 +241,7 @@ class NodeHandler {
   }
 
   protected emitFull(universe: number): void {
-    const full = this.data?.get(universe) ?? this.getNulledUniverse();
+    const full = this.data?.get(universe) ?? nulledUniverse();
     this.sendData({ universe, payload: full });
   }
 
diff --git a/src/nodes/sacn-out/sacn-out.ts b/src/nodes/sacn-out/sacn-out.ts
index 85cfbdf..5eb6ef5 100644
--- a/src/nodes/sacn-out/sacn-out.ts
+++ b/src/nodes/sacn-out/sacn-out.ts
@@ -2,6 +2,8 @@ import { Node, NodeAPI, NodeDef } from "node-red";
 import { NodeMessage } from "@node-red/registry";
 import { Sender } from "sacn";
 import { Options } from "sacn/dist/packet";
+import { nulledUniverse } from "../../lib/dmx";
+import { resolveNetworkOptions } from "../../lib/network";
 
 interface SenderProps {
   universe: number;
@@ -24,10 +26,6 @@ export interface Config extends NodeDef {
   blankOnClose?: boolean;
 }
 
-interface DMXValues {
-  [key: number]: number;
-}
-
 export type MessageIn = NodeMessage;
 
 class NodeHandler {
@@ -43,18 +41,15 @@ class NodeHandler {
     this.node = node;
     this.config = config;
 
+    const network = resolveNetworkOptions(config);
     this.options = {
       universe: config.universe,
       reuseAddr: config.reuseAddress !== undefined ? config.reuseAddress : true,
       minRefreshRate: config.speed !== undefined ? config.speed : 0,
+      port: network.port,
     };
-    if (config.interface !== undefined && config.interface.length > 7) {
-      this.options.iface = config.interface;
-    }
-    if (config.port !== undefined && config.port > 0) {
-      this.options.port = config.port;
-    } else {
-      this.options.port = 5568;
+    if (network.iface !== undefined) {
+      this.options.iface = network.iface;
     }
 
     this.sACN = new Sender(this.options);
@@ -79,7 +74,7 @@ class NodeHandler {
       if (this.config.blankOnClose) {
         this.sACN
           .send({
-            payload: this.getBlankPayload(),
+            payload: nulledUniverse(),
             sourceName: config.sourceName,
             priority: config.priority || 100,
           })
@@ -111,15 +106,6 @@ class NodeHandler {
     this.setStatus();
   }
 
-  protected getBlankPayload(): DMXValues {
-    const payload: DMXValues = {};
-    for (let ch = 1; ch <= 512; ch++) {
-      payload[ch] = 0;
-    }
-
-    return payload;
-  }
-
   protected setStatus(): void {
     const rate = this.config.speed !== undefined && this.config.speed > 0 ? `${this.config.speed} Hz` : "once";
 
diff --git a/src/nodes/scene-controller/scene-controller.ts b/src/nodes/scene-controller/scene-controller.ts
index 6e0afbb..ecac2be 100644
--- a/src/nodes/scene-controller/scene-controller.ts
+++ b/src/nodes/scene-controller/scene-controller.ts
@@ -1,12 +1,9 @@
 import { Node, NodeAPI, NodeDef } from "node-red";
 import { NodeMessage } from "@node-red/registry";
+import { DMXValues, nulledUniverse } from "../../lib/dmx";
 
 type SceneControllerAction = "save" | "play" | "reset";
 
-interface DMXValues {
-  [key: number]: number | undefined;
-}
-
 interface Universes {
   [key: number]: DMXValues;
 }
@@ -336,16 +333,6 @@ class NodeHandler {
     });
   }
 
-  protected getNulledUniverse(): DMXValues {
-    const universe: DMXValues = {};
-
-    for (let ch = 1; ch <= 512; ch++) {
-      universe[ch] = 0;
-    }
-
-    return universe;
-  }
-
   protected handleReset(message: MessageIn): void {
     // TODO
     const resetScene = (scene: number) => {
@@ -366,11 +353,11 @@ class NodeHandler {
           let payload: DMXValues | Universes;
           if (universes.length === 1) {
             universe = parseInt(universes[0], 10);
-            payload = this.getNulledUniverse();
+            payload = nulledUniverse();
           } else {
             payload = {};
             universes.forEach((universe) => {
-              payload[parseInt(universe, 10)] = this.getNulledUniverse();
+              payload[parseInt(universe, 10)] = nulledUniverse();
             });
           }
 

From d0b051c572c9d3f69d7890daca1c697ad3d4ee15 Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 10:16:22 +0200
Subject: [PATCH 17/22] Make the value scale selectable between percent and
 absolute
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

All three nodes now offer a "Values" setting choosing between percentage
(0–100) and raw DMX values (0–255). The receiver converts the library's
percentages to the chosen scale, the sender switches the library between
scaled and raw output, and the scene controller validates against the
matching range and preserves fractional percentages. Editor forms, locales
and help texts are updated accordingly; the default stays percent so
existing flows keep working.
---
 dist/lib/dmx.js                               | 12 +++++++++-
 dist/nodes/sacn-in/locales/de/sacn-in.json    |  5 +++-
 dist/nodes/sacn-in/locales/en-US/sacn-in.json |  5 +++-
 dist/nodes/sacn-in/sacn-in.html               | 21 +++++++++++++++--
 dist/nodes/sacn-in/sacn-in.js                 |  4 +++-
 dist/nodes/sacn-out/locales/de/sacn-out.json  |  5 +++-
 .../sacn-out/locales/en-US/sacn-out.json      |  5 +++-
 dist/nodes/sacn-out/sacn-out.html             | 23 +++++++++++++++++--
 dist/nodes/sacn-out/sacn-out.js               |  3 +++
 .../locales/de/scene-controller.json          |  9 ++++++++
 .../locales/en-US/scene-controller.json       |  9 ++++++++
 .../scene-controller/scene-controller.html    | 19 +++++++++++++--
 .../scene-controller/scene-controller.js      | 11 +++++----
 src/lib/dmx.ts                                | 16 +++++++++++++
 src/nodes/sacn-in/docs.html                   |  7 ++++--
 src/nodes/sacn-in/form.html                   | 10 ++++++++
 src/nodes/sacn-in/init.ts                     |  5 ++++
 src/nodes/sacn-in/locales/de.json             |  5 +++-
 src/nodes/sacn-in/locales/en-US.json          |  5 +++-
 src/nodes/sacn-in/sacn-in.ts                  |  9 ++++++--
 src/nodes/sacn-out/docs.html                  |  9 ++++++--
 src/nodes/sacn-out/form.html                  | 10 ++++++++
 src/nodes/sacn-out/init.ts                    |  5 ++++
 src/nodes/sacn-out/locales/de.json            |  5 +++-
 src/nodes/sacn-out/locales/en-US.json         |  5 +++-
 src/nodes/sacn-out/sacn-out.ts                | 10 ++++++--
 src/nodes/scene-controller/docs.html          |  5 ++--
 src/nodes/scene-controller/form.html          | 10 ++++++++
 src/nodes/scene-controller/init.ts            |  8 ++++++-
 src/nodes/scene-controller/locales/de.json    |  7 ++++++
 src/nodes/scene-controller/locales/en-US.json |  7 ++++++
 .../scene-controller/scene-controller.ts      | 21 ++++++++++++-----
 32 files changed, 253 insertions(+), 37 deletions(-)
 create mode 100644 dist/nodes/scene-controller/locales/de/scene-controller.json
 create mode 100644 dist/nodes/scene-controller/locales/en-US/scene-controller.json
 create mode 100644 src/nodes/scene-controller/locales/de.json
 create mode 100644 src/nodes/scene-controller/locales/en-US.json

diff --git a/dist/lib/dmx.js b/dist/lib/dmx.js
index 2947779..598c8f3 100644
--- a/dist/lib/dmx.js
+++ b/dist/lib/dmx.js
@@ -1,11 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LAST_UNIVERSE = exports.FIRST_UNIVERSE = exports.LAST_CHANNEL = exports.FIRST_CHANNEL = void 0;
+exports.MAX_ABSOLUTE = exports.MAX_PERCENT = exports.LAST_UNIVERSE = exports.FIRST_UNIVERSE = exports.LAST_CHANNEL = exports.FIRST_CHANNEL = void 0;
+exports.maxValue = maxValue;
+exports.fromPercent = fromPercent;
 exports.nulledUniverse = nulledUniverse;
 exports.FIRST_CHANNEL = 1;
 exports.LAST_CHANNEL = 512;
 exports.FIRST_UNIVERSE = 1;
 exports.LAST_UNIVERSE = 63999;
+exports.MAX_PERCENT = 100;
+exports.MAX_ABSOLUTE = 255;
+function maxValue(scale) {
+    return scale === "absolute" ? exports.MAX_ABSOLUTE : exports.MAX_PERCENT;
+}
+function fromPercent(percent, scale) {
+    return scale === "absolute" ? Math.round(percent * 2.55) : percent;
+}
 function nulledUniverse() {
     const universe = {};
     for (let channel = exports.FIRST_CHANNEL; channel <= exports.LAST_CHANNEL; channel++) {
diff --git a/dist/nodes/sacn-in/locales/de/sacn-in.json b/dist/nodes/sacn-in/locales/de/sacn-in.json
index d0aa154..0ac2f79 100644
--- a/dist/nodes/sacn-in/locales/de/sacn-in.json
+++ b/dist/nodes/sacn-in/locales/de/sacn-in.json
@@ -16,7 +16,10 @@
       "trigger_always": "Jedes Paket",
       "trigger_interval": "Änderungen + zyklisch",
       "interval": "Intervall (ms)",
-      "clearOnUniverseChange": "Bei Universumswechsel auf 0 setzen"
+      "clearOnUniverseChange": "Bei Universumswechsel auf 0 setzen",
+      "values": "Werte",
+      "values_percent": "Prozent (0–100)",
+      "values_absolute": "Absolut (0–255)"
     }
   }
 }
\ No newline at end of file
diff --git a/dist/nodes/sacn-in/locales/en-US/sacn-in.json b/dist/nodes/sacn-in/locales/en-US/sacn-in.json
index 678c53a..bf870e0 100644
--- a/dist/nodes/sacn-in/locales/en-US/sacn-in.json
+++ b/dist/nodes/sacn-in/locales/en-US/sacn-in.json
@@ -16,7 +16,10 @@
       "trigger_always": "every packet",
       "trigger_interval": "changes + cyclic",
       "interval": "interval (ms)",
-      "clearOnUniverseChange": "blank on universe change"
+      "clearOnUniverseChange": "blank on universe change",
+      "values": "values",
+      "values_percent": "percent (0–100)",
+      "values_absolute": "absolute (0–255)"
     }
   }
 }
\ No newline at end of file
diff --git a/dist/nodes/sacn-in/sacn-in.html b/dist/nodes/sacn-in/sacn-in.html
index b8ed902..ec9d112 100644
--- a/dist/nodes/sacn-in/sacn-in.html
+++ b/dist/nodes/sacn-in/sacn-in.html
@@ -34,6 +34,16 @@
             <option value="changes" data-i18n="sacn-in.label.output_changes"></option>
         </select>
     </div>
+    <div class="form-row">
+        <label for="node-input-values">
+            <i class="fa fa-sliders"></i>
+            <span data-i18n="sacn-in.label.values"></span>
+        </label>
+        <select id="node-input-values" style="width:70%;">
+            <option value="percent" selected data-i18n="sacn-in.label.values_percent"></option>
+            <option value="absolute" data-i18n="sacn-in.label.values_absolute"></option>
+        </select>
+    </div>
     <div class="form-row">
         <label for="node-input-trigger">
             <i class="fa fa-share-square-o"></i>
@@ -84,8 +94,9 @@ <h3>Details</h3>
         <i>LTP</i> (Latest Takes Precedence).
     </p>
     <p>
-        DMX values in the <code>payload</code> are expressed as a <b>percentage</b> and keyed by
-        DMX channel, starting at key <code>1</code> (not <code>0</code>).
+        DMX values in the <code>payload</code> are keyed by DMX channel, starting at key <code>1</code>
+        (not <code>0</code>). Depending on the <b>Values</b> setting they are expressed as a
+        <b>percentage</b> (<code>0</code>–<code>100</code>) or as raw <b>DMX values</b> (<code>0</code>–<code>255</code>).
     </p>
     <h4>Configuration</h4>
     <dl class="message-properties">
@@ -95,6 +106,8 @@ <h4>Configuration</h4>
         <dd>Whether to emit every received packet or merged values using HTP or LTP.</dd>
         <dt>Output <span class="property-type">full | changes</span></dt>
         <dd>Emit the whole universe on every update (<i>full</i>) or only the changed channels (<i>changes</i>).</dd>
+        <dt>Values <span class="property-type">percent | absolute</span></dt>
+        <dd>Emit channel values as a percentage (<code>0</code>–<code>100</code>) or as raw DMX values (<code>0</code>–<code>255</code>). Default <code>percent</code>.</dd>
         <dt>Output trigger <span class="property-type">changes | always | interval</span></dt>
         <dd>
             Controls <b>when</b> a message is emitted, independently of the mode:
@@ -196,6 +209,10 @@ <h3>References</h3>
             clearOnUniverseChange: {
                 value: false,
             },
+            values: {
+                value: "percent",
+                required: true,
+            },
         },
         inputs: 1,
         outputs: 1,
diff --git a/dist/nodes/sacn-in/sacn-in.js b/dist/nodes/sacn-in/sacn-in.js
index 4249046..4df9289 100644
--- a/dist/nodes/sacn-in/sacn-in.js
+++ b/dist/nodes/sacn-in/sacn-in.js
@@ -11,11 +11,13 @@ class NodeHandler {
     currentUniverse;
     trigger;
     interval;
+    scale;
     keepaliveTimer;
     constructor(node, config) {
         this.node = node;
         this.config = config;
         this.currentUniverse = config.universe;
+        this.scale = config.values ?? "percent";
         this.trigger = config.trigger ?? (config.mode === "passthrough" ? "always" : "changes");
         this.interval = config.interval !== undefined && config.interval > 0 ? config.interval : 1000;
         const network = (0, network_1.resolveNetworkOptions)(config);
@@ -128,7 +130,7 @@ class NodeHandler {
         Object.keys(incoming).forEach((key) => {
             const ch = parseInt(key, 10);
             if (ch >= 1 && ch <= 512) {
-                full[ch] = incoming[ch];
+                full[ch] = (0, dmx_1.fromPercent)(incoming[ch], this.scale);
             }
         });
         let changed = false;
diff --git a/dist/nodes/sacn-out/locales/de/sacn-out.json b/dist/nodes/sacn-out/locales/de/sacn-out.json
index 48122d2..80a05ec 100644
--- a/dist/nodes/sacn-out/locales/de/sacn-out.json
+++ b/dist/nodes/sacn-out/locales/de/sacn-out.json
@@ -13,7 +13,10 @@
       "speed_44": "Maximum (44Hz)",
       "speed_once": "Einmalig (0Hz)",
       "universe": "Universum",
-      "blankOnClose": "Ausgabe beim Stoppen auf 0 setzen"
+      "blankOnClose": "Ausgabe beim Stoppen auf 0 setzen",
+      "values": "Werte",
+      "values_percent": "Prozent (0–100)",
+      "values_absolute": "Absolut (0–255)"
     }
   }
 }
\ No newline at end of file
diff --git a/dist/nodes/sacn-out/locales/en-US/sacn-out.json b/dist/nodes/sacn-out/locales/en-US/sacn-out.json
index 34b357d..425c6cb 100644
--- a/dist/nodes/sacn-out/locales/en-US/sacn-out.json
+++ b/dist/nodes/sacn-out/locales/en-US/sacn-out.json
@@ -13,7 +13,10 @@
       "speed_44": "maximum (44Hz)",
       "speed_once": "once (0Hz)",
       "universe": "universe",
-      "blankOnClose": "blank output on stop"
+      "blankOnClose": "blank output on stop",
+      "values": "values",
+      "values_percent": "percent (0–100)",
+      "values_absolute": "absolute (0–255)"
     }
   }
 }
\ No newline at end of file
diff --git a/dist/nodes/sacn-out/sacn-out.html b/dist/nodes/sacn-out/sacn-out.html
index a19cf57..39d4da1 100644
--- a/dist/nodes/sacn-out/sacn-out.html
+++ b/dist/nodes/sacn-out/sacn-out.html
@@ -41,6 +41,16 @@
         </label>
         <input type="number" id="node-input-priority" min="1" max="200" step="1" style="width:70%;"/>
     </div>
+    <div class="form-row">
+        <label for="node-input-values">
+            <i class="fa fa-sliders"></i>
+            <span data-i18n="sacn-out.label.values"></span>
+        </label>
+        <select id="node-input-values" style="width:70%;">
+            <option value="percent" selected data-i18n="sacn-out.label.values_percent"></option>
+            <option value="absolute" data-i18n="sacn-out.label.values_absolute"></option>
+        </select>
+    </div>
     <div class="form-row">
         <label for="node-input-blankOnClose" style="width:auto;">
             <i class="fa fa-eraser"></i>
@@ -71,8 +81,9 @@ <h3>Details</h3>
         once per message or repeated continuously at the selected refresh rate.
     </p>
     <p>
-        DMX values in the <code>payload</code> are expected as a <b>percentage</b> and keyed by
-        DMX channel, starting at key <code>1</code> (not <code>0</code>).
+        DMX values in the <code>payload</code> are keyed by DMX channel, starting at key <code>1</code>
+        (not <code>0</code>). Depending on the <b>Values</b> setting they are expected as a
+        <b>percentage</b> (<code>0</code>–<code>100</code>) or as raw <b>DMX values</b> (<code>0</code>–<code>255</code>).
     </p>
     <h4>Configuration</h4>
     <dl class="message-properties">
@@ -84,6 +95,10 @@ <h4>Configuration</h4>
         <dd>Refresh rate in Hz: <code>0</code> (once), <code>24</code>, <code>27</code>, <code>30</code>, <code>40</code> or <code>44</code>. Default <code>0</code>.</dd>
         <dt>Priority <span class="property-type">number</span></dt>
         <dd>Priority of the sender, <code>1</code> to <code>200</code>. Default <code>100</code>.</dd>
+        <dt>Values <span class="property-type">percent | absolute</span></dt>
+        <dd>Interpret the incoming payload as a percentage (<code>0</code>–<code>100</code>) or as raw DMX values (<code>0</code>–<code>255</code>). Default <code>percent</code>.</dd>
+        <dt class="optional">Blank output on stop <span class="property-type">boolean</span></dt>
+        <dd>Send an all-zero frame before closing so receivers go dark on stop/redeploy instead of holding the last look. Default <code>false</code>.</dd>
         <dt class="optional">Interface <span class="property-type">string</span></dt>
         <dd>IP address of the network interface used for sending. Leave empty to use the default interface.</dd>
         <dt class="optional">Port <span class="property-type">number</span></dt>
@@ -135,6 +150,10 @@ <h3>References</h3>
             blankOnClose: {
                 value: false,
             },
+            values: {
+                value: "percent",
+                required: true,
+            },
         },
         inputs: 1,
         outputs: 0,
diff --git a/dist/nodes/sacn-out/sacn-out.js b/dist/nodes/sacn-out/sacn-out.js
index 3476889..72844f4 100644
--- a/dist/nodes/sacn-out/sacn-out.js
+++ b/dist/nodes/sacn-out/sacn-out.js
@@ -17,6 +17,9 @@ class NodeHandler {
             reuseAddr: config.reuseAddress !== undefined ? config.reuseAddress : true,
             minRefreshRate: config.speed !== undefined ? config.speed : 0,
             port: network.port,
+            defaultPacketOptions: {
+                useRawDmxValues: (config.values ?? "percent") === "absolute",
+            },
         };
         if (network.iface !== undefined) {
             this.options.iface = network.iface;
diff --git a/dist/nodes/scene-controller/locales/de/scene-controller.json b/dist/nodes/scene-controller/locales/de/scene-controller.json
new file mode 100644
index 0000000..dbd233b
--- /dev/null
+++ b/dist/nodes/scene-controller/locales/de/scene-controller.json
@@ -0,0 +1,9 @@
+{
+  "scene-controller": {
+    "label": {
+      "values": "Werte",
+      "values_percent": "Prozent (0–100)",
+      "values_absolute": "Absolut (0–255)"
+    }
+  }
+}
\ No newline at end of file
diff --git a/dist/nodes/scene-controller/locales/en-US/scene-controller.json b/dist/nodes/scene-controller/locales/en-US/scene-controller.json
new file mode 100644
index 0000000..579358a
--- /dev/null
+++ b/dist/nodes/scene-controller/locales/en-US/scene-controller.json
@@ -0,0 +1,9 @@
+{
+  "scene-controller": {
+    "label": {
+      "values": "values",
+      "values_percent": "percent (0–100)",
+      "values_absolute": "absolute (0–255)"
+    }
+  }
+}
\ No newline at end of file
diff --git a/dist/nodes/scene-controller/scene-controller.html b/dist/nodes/scene-controller/scene-controller.html
index 4ba6b46..45d0fac 100644
--- a/dist/nodes/scene-controller/scene-controller.html
+++ b/dist/nodes/scene-controller/scene-controller.html
@@ -6,6 +6,16 @@
         </label>
         <input type="text" id="node-input-name" data-i18n="[placeholder]node-red:common.label.name" style="width:70%;">
     </div>
+    <div class="form-row">
+        <label for="node-input-values">
+            <i class="fa fa-sliders"></i>
+            <span data-i18n="scene-controller.label.values"></span>
+        </label>
+        <select id="node-input-values" style="width:70%;">
+            <option value="percent" selected data-i18n="scene-controller.label.values_percent"></option>
+            <option value="absolute" data-i18n="scene-controller.label.values_absolute"></option>
+        </select>
+    </div>
 </script>
 <script type="text/html" data-help-name="scene-controller">
     <p>Records DMX scenes and plays them back later.</p>
@@ -21,8 +31,9 @@ <h3>Details</h3>
         <li><code>reset</code> - clear the given scene (or all scenes) and, if it is currently playing, emit a nulled universe.</li>
     </ul>
     <p>
-        DMX values are expressed as a <b>percentage</b> and keyed by DMX channel, starting at key
-        <code>1</code> (not <code>0</code>).
+        DMX values are keyed by DMX channel, starting at key <code>1</code> (not <code>0</code>).
+        The accepted value range follows the <b>Values</b> setting: a percentage (<code>0</code>–<code>100</code>)
+        or raw DMX values (<code>0</code>–<code>255</code>).
     </p>
     <h3>Inputs</h3>
     <dl class="message-properties">
@@ -75,6 +86,10 @@ <h3>References</h3>
             name: {
                 value: "Scene-Controller",
             },
+            values: {
+                value: "percent",
+                required: true,
+            },
         },
         inputs: 1,
         outputs: 1,
diff --git a/dist/nodes/scene-controller/scene-controller.js b/dist/nodes/scene-controller/scene-controller.js
index 37cdb09..ee7d390 100644
--- a/dist/nodes/scene-controller/scene-controller.js
+++ b/dist/nodes/scene-controller/scene-controller.js
@@ -4,9 +4,11 @@ const dmx_1 = require("../../lib/dmx");
 class NodeHandler {
     node;
     config;
+    scale;
     constructor(node, config) {
         this.node = node;
         this.config = config;
+        this.scale = config.values ?? "percent";
         this.node.on("input", (msg) => {
             const message = msg;
             switch (message.action || "undefined") {
@@ -46,8 +48,9 @@ class NodeHandler {
         }
     }
     validateValue(value, channel, universe) {
-        if (isNaN(value) || value < 0 || value > 255) {
-            throw new Error(`Value '${value}' (${typeof value}) for channel '${channel}' of universe '${universe}' is invalid or not between 0 and 255.`);
+        const max = (0, dmx_1.maxValue)(this.scale);
+        if (isNaN(value) || value < 0 || value > max) {
+            throw new Error(`Value '${value}' (${typeof value}) for channel '${channel}' of universe '${universe}' is invalid or not between 0 and ${max}.`);
         }
     }
     parseUniverseObject(input, universe) {
@@ -66,7 +69,7 @@ class NodeHandler {
             }
             this.validateChannel(channel, universe, startIndex, endIndex);
             if (typeof value === "string") {
-                value = parseInt(value);
+                value = parseFloat(value);
             }
             this.validateValue(value, channel, universe);
             output[channel] = value;
@@ -81,7 +84,7 @@ class NodeHandler {
         input.forEach((value, channel) => {
             this.validateChannel(channel, universe, 0, 511);
             if (typeof value === "string") {
-                value = parseInt(value, 10);
+                value = parseFloat(value);
             }
             this.validateValue(value, channel, universe);
             output[channel] = value;
diff --git a/src/lib/dmx.ts b/src/lib/dmx.ts
index 36447da..84b979f 100644
--- a/src/lib/dmx.ts
+++ b/src/lib/dmx.ts
@@ -10,6 +10,22 @@ export const LAST_CHANNEL = 512;
 export const FIRST_UNIVERSE = 1;
 export const LAST_UNIVERSE = 63999;
 
+/** whether channel values are expressed as a percentage (0–100) or as raw DMX bytes (0–255) */
+export type ValueScale = "percent" | "absolute";
+
+export const MAX_PERCENT = 100;
+export const MAX_ABSOLUTE = 255;
+
+/** highest valid channel value for the given scale */
+export function maxValue(scale: ValueScale): number {
+  return scale === "absolute" ? MAX_ABSOLUTE : MAX_PERCENT;
+}
+
+/** the underlying library always works in percent; convert to the configured scale */
+export function fromPercent(percent: number, scale: ValueScale): number {
+  return scale === "absolute" ? Math.round(percent * 2.55) : percent;
+}
+
 /** a full universe with every channel set to 0 */
 export function nulledUniverse(): DMXValues {
   const universe: DMXValues = {};
diff --git a/src/nodes/sacn-in/docs.html b/src/nodes/sacn-in/docs.html
index 94213af..8c7b857 100644
--- a/src/nodes/sacn-in/docs.html
+++ b/src/nodes/sacn-in/docs.html
@@ -9,8 +9,9 @@ <h3>Details</h3>
     <i>LTP</i> (Latest Takes Precedence).
 </p>
 <p>
-    DMX values in the <code>payload</code> are expressed as a <b>percentage</b> and keyed by
-    DMX channel, starting at key <code>1</code> (not <code>0</code>).
+    DMX values in the <code>payload</code> are keyed by DMX channel, starting at key <code>1</code>
+    (not <code>0</code>). Depending on the <b>Values</b> setting they are expressed as a
+    <b>percentage</b> (<code>0</code>–<code>100</code>) or as raw <b>DMX values</b> (<code>0</code>–<code>255</code>).
 </p>
 
 <h4>Configuration</h4>
@@ -21,6 +22,8 @@ <h4>Configuration</h4>
     <dd>Whether to emit every received packet or merged values using HTP or LTP.</dd>
     <dt>Output <span class="property-type">full | changes</span></dt>
     <dd>Emit the whole universe on every update (<i>full</i>) or only the changed channels (<i>changes</i>).</dd>
+    <dt>Values <span class="property-type">percent | absolute</span></dt>
+    <dd>Emit channel values as a percentage (<code>0</code>–<code>100</code>) or as raw DMX values (<code>0</code>–<code>255</code>). Default <code>percent</code>.</dd>
     <dt>Output trigger <span class="property-type">changes | always | interval</span></dt>
     <dd>
         Controls <b>when</b> a message is emitted, independently of the mode:
diff --git a/src/nodes/sacn-in/form.html b/src/nodes/sacn-in/form.html
index 22ae5a5..1612d09 100644
--- a/src/nodes/sacn-in/form.html
+++ b/src/nodes/sacn-in/form.html
@@ -34,6 +34,16 @@
         <option value="changes" data-i18n="sacn-in.label.output_changes"></option>
     </select>
 </div>
+<div class="form-row">
+    <label for="node-input-values">
+        <i class="fa fa-sliders"></i>
+        <span data-i18n="sacn-in.label.values"></span>
+    </label>
+    <select id="node-input-values" style="width:70%;">
+        <option value="percent" selected data-i18n="sacn-in.label.values_percent"></option>
+        <option value="absolute" data-i18n="sacn-in.label.values_absolute"></option>
+    </select>
+</div>
 <div class="form-row">
     <label for="node-input-trigger">
         <i class="fa fa-share-square-o"></i>
diff --git a/src/nodes/sacn-in/init.ts b/src/nodes/sacn-in/init.ts
index 679865a..3354775 100644
--- a/src/nodes/sacn-in/init.ts
+++ b/src/nodes/sacn-in/init.ts
@@ -11,6 +11,7 @@ interface Defaults extends EditorNodeProperties {
   trigger: "changes" | "always" | "interval";
   interval: number;
   clearOnUniverseChange: boolean;
+  values: "percent" | "absolute";
 }
 
 const def: EditorNodeDef<Defaults> = {
@@ -51,6 +52,10 @@ const def: EditorNodeDef<Defaults> = {
     clearOnUniverseChange: {
       value: false,
     },
+    values: {
+      value: "percent",
+      required: true,
+    },
   },
   inputs: 1,
   outputs: 1,
diff --git a/src/nodes/sacn-in/locales/de.json b/src/nodes/sacn-in/locales/de.json
index d9d0b8c..718e366 100644
--- a/src/nodes/sacn-in/locales/de.json
+++ b/src/nodes/sacn-in/locales/de.json
@@ -15,6 +15,9 @@
     "trigger_always": "Jedes Paket",
     "trigger_interval": "Änderungen + zyklisch",
     "interval": "Intervall (ms)",
-    "clearOnUniverseChange": "Bei Universumswechsel auf 0 setzen"
+    "clearOnUniverseChange": "Bei Universumswechsel auf 0 setzen",
+    "values": "Werte",
+    "values_percent": "Prozent (0–100)",
+    "values_absolute": "Absolut (0–255)"
   }
 }
diff --git a/src/nodes/sacn-in/locales/en-US.json b/src/nodes/sacn-in/locales/en-US.json
index 0142a43..d9bd63d 100644
--- a/src/nodes/sacn-in/locales/en-US.json
+++ b/src/nodes/sacn-in/locales/en-US.json
@@ -15,6 +15,9 @@
     "trigger_always": "every packet",
     "trigger_interval": "changes + cyclic",
     "interval": "interval (ms)",
-    "clearOnUniverseChange": "blank on universe change"
+    "clearOnUniverseChange": "blank on universe change",
+    "values": "values",
+    "values_percent": "percent (0–100)",
+    "values_absolute": "absolute (0–255)"
   }
 }
diff --git a/src/nodes/sacn-in/sacn-in.ts b/src/nodes/sacn-in/sacn-in.ts
index e649088..01c132e 100644
--- a/src/nodes/sacn-in/sacn-in.ts
+++ b/src/nodes/sacn-in/sacn-in.ts
@@ -1,7 +1,7 @@
 import { Node, NodeAPI, NodeDef } from "node-red";
 import { NodeMessage } from "@node-red/registry";
 import { Packet, Receiver, unstable_MergingReceiver as MergingReceiver } from "sacn";
-import { DMXValues, nulledUniverse } from "../../lib/dmx";
+import { DMXValues, fromPercent, nulledUniverse, ValueScale } from "../../lib/dmx";
 import { resolveNetworkOptions } from "../../lib/network";
 
 interface Config extends NodeDef {
@@ -14,6 +14,7 @@ interface Config extends NodeDef {
   trigger?: "changes" | "always" | "interval";
   interval?: number;
   clearOnUniverseChange?: boolean;
+  values?: ValueScale;
 }
 
 export interface MessageIn extends NodeMessage {
@@ -42,12 +43,15 @@ class NodeHandler {
 
   protected interval: number;
 
+  protected scale: ValueScale;
+
   protected keepaliveTimer: ReturnType<typeof setTimeout> | undefined;
 
   constructor(node: Node<Config>, config: Config) {
     this.node = node;
     this.config = config;
     this.currentUniverse = config.universe;
+    this.scale = config.values ?? "percent";
 
     // resolve the output trigger; keep legacy behaviour for nodes without the field
     this.trigger = config.trigger ?? (config.mode === "passthrough" ? "always" : "changes");
@@ -208,7 +212,8 @@ class NodeHandler {
     Object.keys(incoming).forEach((key) => {
       const ch = parseInt(key, 10);
       if (ch >= 1 && ch <= 512) {
-        full[ch] = incoming[ch];
+        // the library always reports percentages; convert to the configured scale
+        full[ch] = fromPercent(incoming[ch], this.scale);
       }
     });
 
diff --git a/src/nodes/sacn-out/docs.html b/src/nodes/sacn-out/docs.html
index 5ee0f96..d4b5937 100644
--- a/src/nodes/sacn-out/docs.html
+++ b/src/nodes/sacn-out/docs.html
@@ -7,8 +7,9 @@ <h3>Details</h3>
     once per message or repeated continuously at the selected refresh rate.
 </p>
 <p>
-    DMX values in the <code>payload</code> are expected as a <b>percentage</b> and keyed by
-    DMX channel, starting at key <code>1</code> (not <code>0</code>).
+    DMX values in the <code>payload</code> are keyed by DMX channel, starting at key <code>1</code>
+    (not <code>0</code>). Depending on the <b>Values</b> setting they are expected as a
+    <b>percentage</b> (<code>0</code>–<code>100</code>) or as raw <b>DMX values</b> (<code>0</code>–<code>255</code>).
 </p>
 
 <h4>Configuration</h4>
@@ -21,6 +22,10 @@ <h4>Configuration</h4>
     <dd>Refresh rate in Hz: <code>0</code> (once), <code>24</code>, <code>27</code>, <code>30</code>, <code>40</code> or <code>44</code>. Default <code>0</code>.</dd>
     <dt>Priority <span class="property-type">number</span></dt>
     <dd>Priority of the sender, <code>1</code> to <code>200</code>. Default <code>100</code>.</dd>
+    <dt>Values <span class="property-type">percent | absolute</span></dt>
+    <dd>Interpret the incoming payload as a percentage (<code>0</code>–<code>100</code>) or as raw DMX values (<code>0</code>–<code>255</code>). Default <code>percent</code>.</dd>
+    <dt class="optional">Blank output on stop <span class="property-type">boolean</span></dt>
+    <dd>Send an all-zero frame before closing so receivers go dark on stop/redeploy instead of holding the last look. Default <code>false</code>.</dd>
     <dt class="optional">Interface <span class="property-type">string</span></dt>
     <dd>IP address of the network interface used for sending. Leave empty to use the default interface.</dd>
     <dt class="optional">Port <span class="property-type">number</span></dt>
diff --git a/src/nodes/sacn-out/form.html b/src/nodes/sacn-out/form.html
index a6b1f93..6785356 100644
--- a/src/nodes/sacn-out/form.html
+++ b/src/nodes/sacn-out/form.html
@@ -41,6 +41,16 @@
     </label>
     <input type="number" id="node-input-priority" min="1" max="200" step="1" style="width:70%;"/>
 </div>
+<div class="form-row">
+    <label for="node-input-values">
+        <i class="fa fa-sliders"></i>
+        <span data-i18n="sacn-out.label.values"></span>
+    </label>
+    <select id="node-input-values" style="width:70%;">
+        <option value="percent" selected data-i18n="sacn-out.label.values_percent"></option>
+        <option value="absolute" data-i18n="sacn-out.label.values_absolute"></option>
+    </select>
+</div>
 <div class="form-row">
     <label for="node-input-blankOnClose" style="width:auto;">
         <i class="fa fa-eraser"></i>
diff --git a/src/nodes/sacn-out/init.ts b/src/nodes/sacn-out/init.ts
index d8f32b0..e86458d 100644
--- a/src/nodes/sacn-out/init.ts
+++ b/src/nodes/sacn-out/init.ts
@@ -10,6 +10,7 @@ interface Defaults extends EditorNodeProperties {
   priority: number;
   sourceName: string;
   blankOnClose: boolean;
+  values: "percent" | "absolute";
 }
 
 const def: EditorNodeDef<Defaults> = {
@@ -46,6 +47,10 @@ const def: EditorNodeDef<Defaults> = {
     blankOnClose: {
       value: false,
     },
+    values: {
+      value: "percent",
+      required: true,
+    },
   },
   inputs: 1,
   outputs: 0,
diff --git a/src/nodes/sacn-out/locales/de.json b/src/nodes/sacn-out/locales/de.json
index 9ad54ae..9f9db0c 100644
--- a/src/nodes/sacn-out/locales/de.json
+++ b/src/nodes/sacn-out/locales/de.json
@@ -12,6 +12,9 @@
     "speed_44": "Maximum (44Hz)",
     "speed_once": "Einmalig (0Hz)",
     "universe": "Universum",
-    "blankOnClose": "Ausgabe beim Stoppen auf 0 setzen"
+    "blankOnClose": "Ausgabe beim Stoppen auf 0 setzen",
+    "values": "Werte",
+    "values_percent": "Prozent (0–100)",
+    "values_absolute": "Absolut (0–255)"
   }
 }
diff --git a/src/nodes/sacn-out/locales/en-US.json b/src/nodes/sacn-out/locales/en-US.json
index b9ad716..631a9aa 100644
--- a/src/nodes/sacn-out/locales/en-US.json
+++ b/src/nodes/sacn-out/locales/en-US.json
@@ -12,6 +12,9 @@
     "speed_44": "maximum (44Hz)",
     "speed_once": "once (0Hz)",
     "universe": "universe",
-    "blankOnClose": "blank output on stop"
+    "blankOnClose": "blank output on stop",
+    "values": "values",
+    "values_percent": "percent (0–100)",
+    "values_absolute": "absolute (0–255)"
   }
 }
diff --git a/src/nodes/sacn-out/sacn-out.ts b/src/nodes/sacn-out/sacn-out.ts
index 5eb6ef5..c60e770 100644
--- a/src/nodes/sacn-out/sacn-out.ts
+++ b/src/nodes/sacn-out/sacn-out.ts
@@ -2,7 +2,7 @@ import { Node, NodeAPI, NodeDef } from "node-red";
 import { NodeMessage } from "@node-red/registry";
 import { Sender } from "sacn";
 import { Options } from "sacn/dist/packet";
-import { nulledUniverse } from "../../lib/dmx";
+import { nulledUniverse, ValueScale } from "../../lib/dmx";
 import { resolveNetworkOptions } from "../../lib/network";
 
 interface SenderProps {
@@ -10,7 +10,7 @@ interface SenderProps {
   port?: number;
   reuseAddr?: boolean;
   minRefreshRate?: number;
-  defaultPacketOptions?: Pick<Options, "cid" | "sourceName" | "priority">;
+  defaultPacketOptions?: Pick<Options, "cid" | "sourceName" | "priority" | "useRawDmxValues">;
   iface?: string;
   useUnicastDestination?: string;
 }
@@ -24,6 +24,7 @@ export interface Config extends NodeDef {
   priority?: number;
   speed?: number;
   blankOnClose?: boolean;
+  values?: ValueScale;
 }
 
 export type MessageIn = NodeMessage;
@@ -47,6 +48,11 @@ class NodeHandler {
       reuseAddr: config.reuseAddress !== undefined ? config.reuseAddress : true,
       minRefreshRate: config.speed !== undefined ? config.speed : 0,
       port: network.port,
+      // in absolute mode the payload is already raw DMX (0–255); otherwise the
+      // library scales the percentage values (0–100) when building the packet
+      defaultPacketOptions: {
+        useRawDmxValues: (config.values ?? "percent") === "absolute",
+      },
     };
     if (network.iface !== undefined) {
       this.options.iface = network.iface;
diff --git a/src/nodes/scene-controller/docs.html b/src/nodes/scene-controller/docs.html
index 116d388..a7a514c 100644
--- a/src/nodes/scene-controller/docs.html
+++ b/src/nodes/scene-controller/docs.html
@@ -12,8 +12,9 @@ <h3>Details</h3>
     <li><code>reset</code> - clear the given scene (or all scenes) and, if it is currently playing, emit a nulled universe.</li>
 </ul>
 <p>
-    DMX values are expressed as a <b>percentage</b> and keyed by DMX channel, starting at key
-    <code>1</code> (not <code>0</code>).
+    DMX values are keyed by DMX channel, starting at key <code>1</code> (not <code>0</code>).
+    The accepted value range follows the <b>Values</b> setting: a percentage (<code>0</code>–<code>100</code>)
+    or raw DMX values (<code>0</code>–<code>255</code>).
 </p>
 
 <h3>Inputs</h3>
diff --git a/src/nodes/scene-controller/form.html b/src/nodes/scene-controller/form.html
index 1efc6b2..d0743dc 100644
--- a/src/nodes/scene-controller/form.html
+++ b/src/nodes/scene-controller/form.html
@@ -4,4 +4,14 @@
         <span data-i18n="node-red:common.label.name"></span>
     </label>
     <input type="text" id="node-input-name" data-i18n="[placeholder]node-red:common.label.name" style="width:70%;">
+</div>
+<div class="form-row">
+    <label for="node-input-values">
+        <i class="fa fa-sliders"></i>
+        <span data-i18n="scene-controller.label.values"></span>
+    </label>
+    <select id="node-input-values" style="width:70%;">
+        <option value="percent" selected data-i18n="scene-controller.label.values_percent"></option>
+        <option value="absolute" data-i18n="scene-controller.label.values_absolute"></option>
+    </select>
 </div>
\ No newline at end of file
diff --git a/src/nodes/scene-controller/init.ts b/src/nodes/scene-controller/init.ts
index 34f8b8d..cb43dc0 100644
--- a/src/nodes/scene-controller/init.ts
+++ b/src/nodes/scene-controller/init.ts
@@ -2,7 +2,9 @@ import { EditorNodeDef, EditorNodeProperties, EditorRED } from "node-red";
 
 declare const RED: EditorRED;
 
-type Defaults = EditorNodeProperties;
+interface Defaults extends EditorNodeProperties {
+  values: "percent" | "absolute";
+}
 
 const def: EditorNodeDef<Defaults> = {
   category: "sACN",
@@ -11,6 +13,10 @@ const def: EditorNodeDef<Defaults> = {
     name: {
       value: "Scene-Controller",
     },
+    values: {
+      value: "percent",
+      required: true,
+    },
   },
   inputs: 1,
   outputs: 1,
diff --git a/src/nodes/scene-controller/locales/de.json b/src/nodes/scene-controller/locales/de.json
new file mode 100644
index 0000000..238deef
--- /dev/null
+++ b/src/nodes/scene-controller/locales/de.json
@@ -0,0 +1,7 @@
+{
+  "label": {
+    "values": "Werte",
+    "values_percent": "Prozent (0–100)",
+    "values_absolute": "Absolut (0–255)"
+  }
+}
diff --git a/src/nodes/scene-controller/locales/en-US.json b/src/nodes/scene-controller/locales/en-US.json
new file mode 100644
index 0000000..312a78c
--- /dev/null
+++ b/src/nodes/scene-controller/locales/en-US.json
@@ -0,0 +1,7 @@
+{
+  "label": {
+    "values": "values",
+    "values_percent": "percent (0–100)",
+    "values_absolute": "absolute (0–255)"
+  }
+}
diff --git a/src/nodes/scene-controller/scene-controller.ts b/src/nodes/scene-controller/scene-controller.ts
index ecac2be..0c20d46 100644
--- a/src/nodes/scene-controller/scene-controller.ts
+++ b/src/nodes/scene-controller/scene-controller.ts
@@ -1,6 +1,6 @@
 import { Node, NodeAPI, NodeDef } from "node-red";
 import { NodeMessage } from "@node-red/registry";
-import { DMXValues, nulledUniverse } from "../../lib/dmx";
+import { DMXValues, maxValue, nulledUniverse, ValueScale } from "../../lib/dmx";
 
 type SceneControllerAction = "save" | "play" | "reset";
 
@@ -13,7 +13,9 @@ interface Scene {
   data: Universes;
 }
 
-export type Config = NodeDef;
+export interface Config extends NodeDef {
+  values?: ValueScale;
+}
 
 type MessageInPayload =
   | {
@@ -42,9 +44,12 @@ class NodeHandler {
 
   protected config: Config;
 
+  protected scale: ValueScale;
+
   constructor(node: Node<Config>, config: Config) {
     this.node = node;
     this.config = config;
+    this.scale = config.values ?? "percent";
 
     this.node.on("input", (msg) => {
       const message: MessageIn = msg as MessageIn;
@@ -100,9 +105,11 @@ class NodeHandler {
   }
 
   protected validateValue(value: number, channel: number, universe: number): void {
-    if (isNaN(value) || value < 0 || value > 255) {
+    const max = maxValue(this.scale);
+
+    if (isNaN(value) || value < 0 || value > max) {
       throw new Error(
-        `Value '${value}' (${typeof value}) for channel '${channel}' of universe '${universe}' is invalid or not between 0 and 255.`,
+        `Value '${value}' (${typeof value}) for channel '${channel}' of universe '${universe}' is invalid or not between 0 and ${max}.`,
       );
     }
   }
@@ -128,7 +135,8 @@ class NodeHandler {
       this.validateChannel(channel as number, universe, startIndex, endIndex);
 
       if (typeof value === "string") {
-        value = parseInt(value);
+        // parse as float so fractional percentage values keep their precision
+        value = parseFloat(value);
       }
 
       this.validateValue(value as number, channel as number, universe);
@@ -150,7 +158,8 @@ class NodeHandler {
       this.validateChannel(channel, universe, 0, 511);
 
       if (typeof value === "string") {
-        value = parseInt(value, 10);
+        // parse as float so fractional percentage values keep their precision
+        value = parseFloat(value);
       }
 
       this.validateValue(value as number, channel, universe);

From 8dd0e3fa82f7b850ec56dd4bca80818c0da4f03f Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 10:22:03 +0200
Subject: [PATCH 18/22] Offer available network interfaces and validate
 addresses

Add an admin endpoint that lists the host's IPv4 interfaces and offer them
as suggestions on the interface field of both nodes, so the interface can
be picked instead of typed. Replace the length-based interface guess with
real IPv4 validation when binding, and validate the universe, port and
interface fields in the editor. Binding to a chosen interface also avoids
multicast-routing ambiguity on hosts with several gateways.
---
 dist/lib/interfaces.js            | 27 ++++++++++++++
 dist/lib/network.js               |  3 +-
 dist/nodes/sacn-in/sacn-in.html   | 54 ++++++++++++++++++++++++++-
 dist/nodes/sacn-in/sacn-in.js     |  2 +
 dist/nodes/sacn-out/sacn-out.html | 56 +++++++++++++++++++++++++++-
 dist/nodes/sacn-out/sacn-out.js   |  2 +
 src/lib/interfaces.ts             | 37 ++++++++++++++++++
 src/lib/network.ts                |  5 ++-
 src/nodes/sacn-in/form.html       |  3 +-
 src/nodes/sacn-in/init.ts         | 61 ++++++++++++++++++++++++++++++
 src/nodes/sacn-in/sacn-in.ts      |  3 ++
 src/nodes/sacn-out/form.html      |  3 +-
 src/nodes/sacn-out/init.ts        | 62 +++++++++++++++++++++++++++++++
 src/nodes/sacn-out/sacn-out.ts    |  3 ++
 14 files changed, 315 insertions(+), 6 deletions(-)
 create mode 100644 dist/lib/interfaces.js
 create mode 100644 src/lib/interfaces.ts

diff --git a/dist/lib/interfaces.js b/dist/lib/interfaces.js
new file mode 100644
index 0000000..df0c2e9
--- /dev/null
+++ b/dist/lib/interfaces.js
@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listInterfaces = listInterfaces;
+exports.registerInterfaceEndpoint = registerInterfaceEndpoint;
+const node_os_1 = require("node:os");
+function listInterfaces() {
+    const result = [];
+    const interfaces = (0, node_os_1.networkInterfaces)();
+    for (const name of Object.keys(interfaces)) {
+        for (const info of interfaces[name] ?? []) {
+            if (info.family === "IPv4") {
+                result.push({ name, address: info.address });
+            }
+        }
+    }
+    return result;
+}
+let registered = false;
+function registerInterfaceEndpoint(RED) {
+    if (registered) {
+        return;
+    }
+    registered = true;
+    RED.httpAdmin.get("/sacn/interfaces", RED.auth.needsPermission("flows.read"), (_req, res) => {
+        res.json(listInterfaces());
+    });
+}
diff --git a/dist/lib/network.js b/dist/lib/network.js
index 0c013e4..e622fea 100644
--- a/dist/lib/network.js
+++ b/dist/lib/network.js
@@ -2,12 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_PORT = void 0;
 exports.resolveNetworkOptions = resolveNetworkOptions;
+const node_net_1 = require("node:net");
 exports.DEFAULT_PORT = 5568;
 function resolveNetworkOptions(config) {
     const options = {
         port: config.port !== undefined && config.port > 0 ? config.port : exports.DEFAULT_PORT,
     };
-    if (config.interface !== undefined && config.interface.length > 7) {
+    if (config.interface !== undefined && (0, node_net_1.isIP)(config.interface) === 4) {
         options.iface = config.interface;
     }
     return options;
diff --git a/dist/nodes/sacn-in/sacn-in.html b/dist/nodes/sacn-in/sacn-in.html
index ec9d112..7a7936b 100644
--- a/dist/nodes/sacn-in/sacn-in.html
+++ b/dist/nodes/sacn-in/sacn-in.html
@@ -74,7 +74,8 @@
             <i class="fa fa-plug"></i>
             <span data-i18n="sacn-in.label.interface"></span>
         </label>
-        <input type="text" id="node-input-interface" pattern="\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}" style="width:70%;"/>
+        <input type="text" id="node-input-interface" list="node-input-interface-options" style="width:70%;"/>
+        <datalist id="node-input-interface-options"></datalist>
     </div>
     <div class="form-row">
         <label for="node-input-port">
@@ -171,6 +172,47 @@ <h3>References</h3>
     </ul>
 </script>
 <script type="text/javascript">
+    function populateInterfaceOptions() {
+        const list = document.getElementById("node-input-interface-options");
+        if (!list) {
+            return;
+        }
+        $.getJSON("sacn/interfaces", (interfaces) => {
+            list.replaceChildren();
+            interfaces.forEach((iface) => {
+                const option = document.createElement("option");
+                option.value = iface.address;
+                option.label = `${iface.name} (${iface.address})`;
+                list.appendChild(option);
+            });
+        });
+    }
+    function toInt(value) {
+        if (typeof value === "number") {
+            return value;
+        }
+        if (typeof value === "string") {
+            return parseInt(value, 10);
+        }
+        return NaN;
+    }
+    function isValidInterface(value) {
+        if (typeof value !== "string" || value === "") {
+            return true;
+        }
+        return /^(\d{1,3}\.){3}\d{1,3}$/.test(value);
+    }
+    function isValidUniverse(value) {
+        const n = toInt(value);
+        return !isNaN(n) && n >= 1 && n <= 63999;
+    }
+    function isValidPort(value) {
+        if (value === undefined || value === null || value === "") {
+            return true;
+        }
+        const n = toInt(value);
+        return !isNaN(n) && n >= 1 && n <= 65535;
+    }
     const def = {
         category: "sACN",
         color: "#dcc515",
@@ -181,14 +223,23 @@ <h3>References</h3>
             universe: {
                 value: 1,
                 required: true,
+                validate: function (v) {
+                    return isValidUniverse(v);
+                },
             },
             port: {
                 value: undefined,
                 required: false,
+                validate: function (v) {
+                    return isValidPort(v);
+                },
             },
             interface: {
                 value: "",
                 required: false,
+                validate: function (v) {
+                    return isValidInterface(v);
+                },
             },
             mode: {
                 value: "htp",
@@ -234,6 +285,7 @@ <h3>References</h3>
             };
             select?.addEventListener("change", toggleInterval);
             toggleInterval();
+            populateInterfaceOptions();
         },
     };
     RED.nodes.registerType("sacn-in", def);
diff --git a/dist/nodes/sacn-in/sacn-in.js b/dist/nodes/sacn-in/sacn-in.js
index 4df9289..9ca2791 100644
--- a/dist/nodes/sacn-in/sacn-in.js
+++ b/dist/nodes/sacn-in/sacn-in.js
@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const sacn_1 = require("sacn");
 const dmx_1 = require("../../lib/dmx");
 const network_1 = require("../../lib/network");
+const interfaces_1 = require("../../lib/interfaces");
 class NodeHandler {
     node;
     config;
@@ -178,6 +179,7 @@ class NodeHandler {
     }
 }
 exports.default = (RED) => {
+    (0, interfaces_1.registerInterfaceEndpoint)(RED);
     RED.nodes.registerType("sacn-in", function (config) {
         RED.nodes.createNode(this, config);
         new NodeHandler(this, config);
diff --git a/dist/nodes/sacn-out/sacn-out.html b/dist/nodes/sacn-out/sacn-out.html
index 39d4da1..b5e05b1 100644
--- a/dist/nodes/sacn-out/sacn-out.html
+++ b/dist/nodes/sacn-out/sacn-out.html
@@ -63,7 +63,8 @@
             <i class="fa fa-plug"></i>
             <span data-i18n="sacn-out.label.interface"></span>
         </label>
-        <input type="text" id="node-input-interface" pattern="\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}" style="width:70%;"/>
+        <input type="text" id="node-input-interface" list="node-input-interface-options" style="width:70%;"/>
+        <datalist id="node-input-interface-options"></datalist>
     </div>
     <div class="form-row">
         <label for="node-input-port">
@@ -116,6 +117,47 @@ <h3>References</h3>
     </ul>
 </script>
 <script type="text/javascript">
+    function populateInterfaceOptions() {
+        const list = document.getElementById("node-input-interface-options");
+        if (!list) {
+            return;
+        }
+        $.getJSON("sacn/interfaces", (interfaces) => {
+            list.replaceChildren();
+            interfaces.forEach((iface) => {
+                const option = document.createElement("option");
+                option.value = iface.address;
+                option.label = `${iface.name} (${iface.address})`;
+                list.appendChild(option);
+            });
+        });
+    }
+    function toInt(value) {
+        if (typeof value === "number") {
+            return value;
+        }
+        if (typeof value === "string") {
+            return parseInt(value, 10);
+        }
+        return NaN;
+    }
+    function isValidInterface(value) {
+        if (typeof value !== "string" || value === "") {
+            return true;
+        }
+        return /^(\d{1,3}\.){3}\d{1,3}$/.test(value);
+    }
+    function isValidUniverse(value) {
+        const n = toInt(value);
+        return !isNaN(n) && n >= 1 && n <= 63999;
+    }
+    function isValidPort(value) {
+        if (value === undefined || value === null || value === "") {
+            return true;
+        }
+        const n = toInt(value);
+        return !isNaN(n) && n >= 1 && n <= 65535;
+    }
     const def = {
         category: "sACN",
         color: "#dcc515",
@@ -126,14 +168,23 @@ <h3>References</h3>
             universe: {
                 value: 1,
                 required: true,
+                validate: function (v) {
+                    return isValidUniverse(v);
+                },
             },
             port: {
                 value: undefined,
                 required: false,
+                validate: function (v) {
+                    return isValidPort(v);
+                },
             },
             interface: {
                 value: "",
                 required: false,
+                validate: function (v) {
+                    return isValidInterface(v);
+                },
             },
             speed: {
                 value: 0,
@@ -165,6 +216,9 @@ <h3>References</h3>
         labelStyle: function () {
             return this.name ? "node_label_italic" : "";
         },
+        oneditprepare: function () {
+            populateInterfaceOptions();
+        },
     };
     RED.nodes.registerType("sacn-out", def);
 </script>
diff --git a/dist/nodes/sacn-out/sacn-out.js b/dist/nodes/sacn-out/sacn-out.js
index 72844f4..da96859 100644
--- a/dist/nodes/sacn-out/sacn-out.js
+++ b/dist/nodes/sacn-out/sacn-out.js
@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const sacn_1 = require("sacn");
 const dmx_1 = require("../../lib/dmx");
 const network_1 = require("../../lib/network");
+const interfaces_1 = require("../../lib/interfaces");
 class NodeHandler {
     node;
     config;
@@ -75,6 +76,7 @@ class NodeHandler {
     }
 }
 exports.default = (RED) => {
+    (0, interfaces_1.registerInterfaceEndpoint)(RED);
     RED.nodes.registerType("sacn-out", function (config) {
         RED.nodes.createNode(this, config);
         new NodeHandler(this, config);
diff --git a/src/lib/interfaces.ts b/src/lib/interfaces.ts
new file mode 100644
index 0000000..ccbb886
--- /dev/null
+++ b/src/lib/interfaces.ts
@@ -0,0 +1,37 @@
+import { networkInterfaces } from "node:os";
+import { NodeAPI } from "node-red";
+
+export interface InterfaceInfo {
+  name: string;
+  address: string;
+}
+
+/** all local IPv4 interfaces with their address, for the editor to offer */
+export function listInterfaces(): InterfaceInfo[] {
+  const result: InterfaceInfo[] = [];
+  const interfaces = networkInterfaces();
+
+  for (const name of Object.keys(interfaces)) {
+    for (const info of interfaces[name] ?? []) {
+      if (info.family === "IPv4") {
+        result.push({ name, address: info.address });
+      }
+    }
+  }
+
+  return result;
+}
+
+let registered = false;
+
+/** register the admin endpoint that lists the interfaces; safe to call more than once */
+export function registerInterfaceEndpoint(RED: NodeAPI): void {
+  if (registered) {
+    return;
+  }
+  registered = true;
+
+  RED.httpAdmin.get("/sacn/interfaces", RED.auth.needsPermission("flows.read"), (_req, res) => {
+    res.json(listInterfaces());
+  });
+}
diff --git a/src/lib/network.ts b/src/lib/network.ts
index 3fba3eb..a5abcd3 100644
--- a/src/lib/network.ts
+++ b/src/lib/network.ts
@@ -1,3 +1,5 @@
+import { isIP } from "node:net";
+
 export interface NetworkConfig {
   interface?: string;
   port?: number;
@@ -17,7 +19,8 @@ export function resolveNetworkOptions(config: NetworkConfig): NetworkOptions {
     port: config.port !== undefined && config.port > 0 ? config.port : DEFAULT_PORT,
   };
 
-  if (config.interface !== undefined && config.interface.length > 7) {
+  // only bind to a specific interface when a valid IPv4 address is configured
+  if (config.interface !== undefined && isIP(config.interface) === 4) {
     options.iface = config.interface;
   }
 
diff --git a/src/nodes/sacn-in/form.html b/src/nodes/sacn-in/form.html
index 1612d09..1959635 100644
--- a/src/nodes/sacn-in/form.html
+++ b/src/nodes/sacn-in/form.html
@@ -74,7 +74,8 @@
         <i class="fa fa-plug"></i>
         <span data-i18n="sacn-in.label.interface"></span>
     </label>
-    <input type="text" id="node-input-interface" pattern="\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}" style="width:70%;"/>
+    <input type="text" id="node-input-interface" list="node-input-interface-options" style="width:70%;"/>
+    <datalist id="node-input-interface-options"></datalist>
 </div>
 <div class="form-row">
     <label for="node-input-port">
diff --git a/src/nodes/sacn-in/init.ts b/src/nodes/sacn-in/init.ts
index 3354775..ebdecd2 100644
--- a/src/nodes/sacn-in/init.ts
+++ b/src/nodes/sacn-in/init.ts
@@ -1,6 +1,56 @@
 import { EditorNodeDef, EditorNodeProperties, EditorRED } from "node-red";
 
 declare const RED: EditorRED;
+declare const $: {
+  getJSON(url: string, success: (data: { name: string; address: string }[]) => void): void;
+};
+
+function populateInterfaceOptions(): void {
+  const list = document.getElementById("node-input-interface-options");
+  if (!list) {
+    return;
+  }
+
+  $.getJSON("sacn/interfaces", (interfaces) => {
+    list.replaceChildren();
+    interfaces.forEach((iface) => {
+      const option = document.createElement("option");
+      option.value = iface.address;
+      option.label = `${iface.name} (${iface.address})`;
+      list.appendChild(option);
+    });
+  });
+}
+
+function toInt(value: unknown): number {
+  if (typeof value === "number") {
+    return value;
+  }
+  if (typeof value === "string") {
+    return parseInt(value, 10);
+  }
+  return NaN;
+}
+
+function isValidInterface(value: unknown): boolean {
+  if (typeof value !== "string" || value === "") {
+    return true;
+  }
+  return /^(\d{1,3}\.){3}\d{1,3}$/.test(value);
+}
+
+function isValidUniverse(value: unknown): boolean {
+  const n = toInt(value);
+  return !isNaN(n) && n >= 1 && n <= 63999;
+}
+
+function isValidPort(value: unknown): boolean {
+  if (value === undefined || value === null || value === "") {
+    return true;
+  }
+  const n = toInt(value);
+  return !isNaN(n) && n >= 1 && n <= 65535;
+}
 
 interface Defaults extends EditorNodeProperties {
   universe: number;
@@ -24,14 +74,23 @@ const def: EditorNodeDef<Defaults> = {
     universe: {
       value: 1,
       required: true,
+      validate: function (v) {
+        return isValidUniverse(v);
+      },
     },
     port: {
       value: undefined,
       required: false,
+      validate: function (v) {
+        return isValidPort(v);
+      },
     },
     interface: {
       value: "",
       required: false,
+      validate: function (v) {
+        return isValidInterface(v);
+      },
     },
     mode: {
       value: "htp",
@@ -79,6 +138,8 @@ const def: EditorNodeDef<Defaults> = {
 
     select?.addEventListener("change", toggleInterval);
     toggleInterval();
+
+    populateInterfaceOptions();
   },
 };
 
diff --git a/src/nodes/sacn-in/sacn-in.ts b/src/nodes/sacn-in/sacn-in.ts
index 01c132e..6e52bc1 100644
--- a/src/nodes/sacn-in/sacn-in.ts
+++ b/src/nodes/sacn-in/sacn-in.ts
@@ -3,6 +3,7 @@ import { NodeMessage } from "@node-red/registry";
 import { Packet, Receiver, unstable_MergingReceiver as MergingReceiver } from "sacn";
 import { DMXValues, fromPercent, nulledUniverse, ValueScale } from "../../lib/dmx";
 import { resolveNetworkOptions } from "../../lib/network";
+import { registerInterfaceEndpoint } from "../../lib/interfaces";
 
 interface Config extends NodeDef {
   universe: number;
@@ -275,6 +276,8 @@ class NodeHandler {
 }
 
 export default (RED: NodeAPI): void => {
+  registerInterfaceEndpoint(RED);
+
   RED.nodes.registerType("sacn-in", function (this: Node<Config>, config: Config) {
     RED.nodes.createNode(this, config);
 
diff --git a/src/nodes/sacn-out/form.html b/src/nodes/sacn-out/form.html
index 6785356..7b056bc 100644
--- a/src/nodes/sacn-out/form.html
+++ b/src/nodes/sacn-out/form.html
@@ -63,7 +63,8 @@
         <i class="fa fa-plug"></i>
         <span data-i18n="sacn-out.label.interface"></span>
     </label>
-    <input type="text" id="node-input-interface" pattern="\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}" style="width:70%;"/>
+    <input type="text" id="node-input-interface" list="node-input-interface-options" style="width:70%;"/>
+    <datalist id="node-input-interface-options"></datalist>
 </div>
 <div class="form-row">
     <label for="node-input-port">
diff --git a/src/nodes/sacn-out/init.ts b/src/nodes/sacn-out/init.ts
index e86458d..8ee773c 100644
--- a/src/nodes/sacn-out/init.ts
+++ b/src/nodes/sacn-out/init.ts
@@ -1,6 +1,56 @@
 import { EditorNodeDef, EditorNodeProperties, EditorRED } from "node-red";
 
 declare const RED: EditorRED;
+declare const $: {
+  getJSON(url: string, success: (data: { name: string; address: string }[]) => void): void;
+};
+
+function populateInterfaceOptions(): void {
+  const list = document.getElementById("node-input-interface-options");
+  if (!list) {
+    return;
+  }
+
+  $.getJSON("sacn/interfaces", (interfaces) => {
+    list.replaceChildren();
+    interfaces.forEach((iface) => {
+      const option = document.createElement("option");
+      option.value = iface.address;
+      option.label = `${iface.name} (${iface.address})`;
+      list.appendChild(option);
+    });
+  });
+}
+
+function toInt(value: unknown): number {
+  if (typeof value === "number") {
+    return value;
+  }
+  if (typeof value === "string") {
+    return parseInt(value, 10);
+  }
+  return NaN;
+}
+
+function isValidInterface(value: unknown): boolean {
+  if (typeof value !== "string" || value === "") {
+    return true;
+  }
+  return /^(\d{1,3}\.){3}\d{1,3}$/.test(value);
+}
+
+function isValidUniverse(value: unknown): boolean {
+  const n = toInt(value);
+  return !isNaN(n) && n >= 1 && n <= 63999;
+}
+
+function isValidPort(value: unknown): boolean {
+  if (value === undefined || value === null || value === "") {
+    return true;
+  }
+  const n = toInt(value);
+  return !isNaN(n) && n >= 1 && n <= 65535;
+}
 
 interface Defaults extends EditorNodeProperties {
   universe: number;
@@ -23,14 +73,23 @@ const def: EditorNodeDef<Defaults> = {
     universe: {
       value: 1,
       required: true,
+      validate: function (v) {
+        return isValidUniverse(v);
+      },
     },
     port: {
       value: undefined,
       required: false,
+      validate: function (v) {
+        return isValidPort(v);
+      },
     },
     interface: {
       value: "",
       required: false,
+      validate: function (v) {
+        return isValidInterface(v);
+      },
     },
     speed: {
       value: 0,
@@ -62,6 +121,9 @@ const def: EditorNodeDef<Defaults> = {
   labelStyle: function () {
     return this.name ? "node_label_italic" : "";
   },
+  oneditprepare: function () {
+    populateInterfaceOptions();
+  },
 };
 
 RED.nodes.registerType("sacn-out", def);
diff --git a/src/nodes/sacn-out/sacn-out.ts b/src/nodes/sacn-out/sacn-out.ts
index c60e770..c4505ab 100644
--- a/src/nodes/sacn-out/sacn-out.ts
+++ b/src/nodes/sacn-out/sacn-out.ts
@@ -4,6 +4,7 @@ import { Sender } from "sacn";
 import { Options } from "sacn/dist/packet";
 import { nulledUniverse, ValueScale } from "../../lib/dmx";
 import { resolveNetworkOptions } from "../../lib/network";
+import { registerInterfaceEndpoint } from "../../lib/interfaces";
 
 interface SenderProps {
   universe: number;
@@ -124,6 +125,8 @@ class NodeHandler {
 }
 
 export default (RED: NodeAPI): void => {
+  registerInterfaceEndpoint(RED);
+
   RED.nodes.registerType("sacn-out", function (this: Node<Config>, config: Config) {
     RED.nodes.createNode(this, config);
 

From c22291d89ea20e4dd17c4bdfbec5ec8eaec51ffc Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 10:24:11 +0200
Subject: [PATCH 19/22] Persist recorded scenes to disk

Scenes were kept in the in-memory context and lost on every Node-RED
restart. Store them as a JSON file per node in a sacn-scenes directory
under the Node-RED user directory, loaded on start and written on every
save and reset, so recorded scenes survive restarts. This also replaces the
context-key handling and resolves the leftover reset placeholder.
---
 dist/lib/scene-store.js                       | 28 ++++++++++++
 .../scene-controller/scene-controller.html    |  6 +--
 .../scene-controller/scene-controller.js      | 38 ++++++++--------
 src/lib/scene-store.ts                        | 30 +++++++++++++
 src/nodes/scene-controller/docs.html          |  6 +--
 .../scene-controller/scene-controller.ts      | 45 ++++++++++---------
 6 files changed, 109 insertions(+), 44 deletions(-)
 create mode 100644 dist/lib/scene-store.js
 create mode 100644 src/lib/scene-store.ts

diff --git a/dist/lib/scene-store.js b/dist/lib/scene-store.js
new file mode 100644
index 0000000..70d7770
--- /dev/null
+++ b/dist/lib/scene-store.js
@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SceneStore = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+class SceneStore {
+    file;
+    constructor(baseDir, nodeId) {
+        const dir = (0, node_path_1.join)(baseDir, "sacn-scenes");
+        (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+        this.file = (0, node_path_1.join)(dir, `${nodeId}.json`);
+    }
+    load() {
+        if (!(0, node_fs_1.existsSync)(this.file)) {
+            return {};
+        }
+        try {
+            return JSON.parse((0, node_fs_1.readFileSync)(this.file, "utf8"));
+        }
+        catch {
+            return {};
+        }
+    }
+    save(scenes) {
+        (0, node_fs_1.writeFileSync)(this.file, JSON.stringify(scenes));
+    }
+}
+exports.SceneStore = SceneStore;
diff --git a/dist/nodes/scene-controller/scene-controller.html b/dist/nodes/scene-controller/scene-controller.html
index 45d0fac..7081ef4 100644
--- a/dist/nodes/scene-controller/scene-controller.html
+++ b/dist/nodes/scene-controller/scene-controller.html
@@ -21,9 +21,9 @@
     <p>Records DMX scenes and plays them back later.</p>
     <h3>Details</h3>
     <p>
-        The node stores DMX values for one or more universes as named <b>scenes</b> in the node's
-        context and replays them on demand. The requested operation is selected via the
-        <code>action</code> property of the incoming message:
+        The node stores DMX values for one or more universes as named <b>scenes</b> on disk (in the
+        Node-RED user directory) so they survive a restart, and replays them on demand. The requested
+        operation is selected via the <code>action</code> property of the incoming message:
     </p>
     <ul>
         <li><code>save</code> - store the <code>payload</code> as the given scene.</li>
diff --git a/dist/nodes/scene-controller/scene-controller.js b/dist/nodes/scene-controller/scene-controller.js
index ee7d390..3644c1a 100644
--- a/dist/nodes/scene-controller/scene-controller.js
+++ b/dist/nodes/scene-controller/scene-controller.js
@@ -1,14 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const dmx_1 = require("../../lib/dmx");
+const scene_store_1 = require("../../lib/scene-store");
 class NodeHandler {
     node;
     config;
     scale;
-    constructor(node, config) {
+    store;
+    scenes;
+    playingScene = null;
+    constructor(node, config, store) {
         this.node = node;
         this.config = config;
         this.scale = config.values ?? "percent";
+        this.store = store;
+        this.scenes = store.load();
         this.node.on("input", (msg) => {
             const message = msg;
             switch (message.action || "undefined") {
@@ -194,19 +200,19 @@ class NodeHandler {
         return true;
     }
     handleSave(message) {
-        const scene = {
+        this.scenes[message.scene] = {
             scene: message.scene,
             data: message.payload,
         };
-        this.node.context().set(`scene-${message.scene}`, scene);
+        this.store.save(this.scenes);
     }
     handlePlay(message) {
-        const data = this.node.context().get(`scene-${message.scene}`);
+        const data = this.scenes[message.scene];
         if (!data) {
             this.node.warn(`Cannot play scene no. ${message.scene} since it has not been recorded yet.`);
             return;
         }
-        this.node.context().set("playingScene", message.scene);
+        this.playingScene = message.scene;
         let payload;
         let universe = undefined;
         const universes = Object.keys(data.data);
@@ -232,9 +238,9 @@ class NodeHandler {
     }
     handleReset(message) {
         const resetScene = (scene) => {
-            const data = this.node.context().get(`scene-${scene}`);
-            if (this.node.context().get("playingScene") === scene) {
-                this.node.context().set("playingScene", null);
+            const data = this.scenes[scene];
+            if (this.playingScene === scene) {
+                this.playingScene = null;
                 this.node.status({
                     fill: "green",
                     shape: "ring",
@@ -264,27 +270,23 @@ class NodeHandler {
                     this.node.send(out);
                 }
             }
-            this.node.context().set(`scene-${scene}`, undefined);
+            delete this.scenes[scene];
         };
         if (message.scene) {
             resetScene(message.scene);
         }
         else {
-            this.node
-                .context()
-                .keys()
-                .forEach((key) => {
-                const matches = key.match(/^scene-(\d+)/);
-                if (matches !== null) {
-                    resetScene(parseInt(matches[1], 10));
-                }
+            Object.keys(this.scenes).forEach((key) => {
+                resetScene(parseInt(key, 10));
             });
         }
+        this.store.save(this.scenes);
     }
 }
 exports.default = (RED) => {
     RED.nodes.registerType("scene-controller", function (config) {
         RED.nodes.createNode(this, config);
-        new NodeHandler(this, config);
+        const baseDir = RED.settings.userDir ?? process.cwd();
+        new NodeHandler(this, config, new scene_store_1.SceneStore(baseDir, this.id));
     });
 };
diff --git a/src/lib/scene-store.ts b/src/lib/scene-store.ts
new file mode 100644
index 0000000..3f9a00c
--- /dev/null
+++ b/src/lib/scene-store.ts
@@ -0,0 +1,30 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+
+/** persists recorded scenes to a JSON file so they survive a Node-RED restart */
+export class SceneStore<T> {
+  private readonly file: string;
+
+  constructor(baseDir: string, nodeId: string) {
+    const dir = join(baseDir, "sacn-scenes");
+    mkdirSync(dir, { recursive: true });
+    this.file = join(dir, `${nodeId}.json`);
+  }
+
+  load(): Record<number, T> {
+    if (!existsSync(this.file)) {
+      return {};
+    }
+
+    try {
+      return JSON.parse(readFileSync(this.file, "utf8")) as Record<number, T>;
+    } catch {
+      // a corrupt or unreadable file must not take the node down; start empty
+      return {};
+    }
+  }
+
+  save(scenes: Record<number, T>): void {
+    writeFileSync(this.file, JSON.stringify(scenes));
+  }
+}
diff --git a/src/nodes/scene-controller/docs.html b/src/nodes/scene-controller/docs.html
index a7a514c..32eeacb 100644
--- a/src/nodes/scene-controller/docs.html
+++ b/src/nodes/scene-controller/docs.html
@@ -2,9 +2,9 @@
 
 <h3>Details</h3>
 <p>
-    The node stores DMX values for one or more universes as named <b>scenes</b> in the node's
-    context and replays them on demand. The requested operation is selected via the
-    <code>action</code> property of the incoming message:
+    The node stores DMX values for one or more universes as named <b>scenes</b> on disk (in the
+    Node-RED user directory) so they survive a restart, and replays them on demand. The requested
+    operation is selected via the <code>action</code> property of the incoming message:
 </p>
 <ul>
     <li><code>save</code> - store the <code>payload</code> as the given scene.</li>
diff --git a/src/nodes/scene-controller/scene-controller.ts b/src/nodes/scene-controller/scene-controller.ts
index 0c20d46..39549e8 100644
--- a/src/nodes/scene-controller/scene-controller.ts
+++ b/src/nodes/scene-controller/scene-controller.ts
@@ -1,6 +1,7 @@
 import { Node, NodeAPI, NodeDef } from "node-red";
 import { NodeMessage } from "@node-red/registry";
 import { DMXValues, maxValue, nulledUniverse, ValueScale } from "../../lib/dmx";
+import { SceneStore } from "../../lib/scene-store";
 
 type SceneControllerAction = "save" | "play" | "reset";
 
@@ -46,10 +47,18 @@ class NodeHandler {
 
   protected scale: ValueScale;
 
-  constructor(node: Node<Config>, config: Config) {
+  protected store: SceneStore<Scene>;
+
+  protected scenes: Record<number, Scene>;
+
+  protected playingScene: number | null = null;
+
+  constructor(node: Node<Config>, config: Config, store: SceneStore<Scene>) {
     this.node = node;
     this.config = config;
     this.scale = config.values ?? "percent";
+    this.store = store;
+    this.scenes = store.load();
 
     this.node.on("input", (msg) => {
       const message: MessageIn = msg as MessageIn;
@@ -300,22 +309,22 @@ class NodeHandler {
   }
 
   protected handleSave(message: MessageIn) {
-    const scene: Scene = {
+    this.scenes[message.scene] = {
       scene: message.scene,
       data: message.payload as Universes,
     };
-    this.node.context().set(`scene-${message.scene}`, scene);
+    this.store.save(this.scenes);
   }
 
   protected handlePlay(message: MessageIn): void {
-    const data: Scene | null = this.node.context().get(`scene-${message.scene}`) as Scene | null;
+    const data: Scene | undefined = this.scenes[message.scene];
     if (!data) {
       this.node.warn(`Cannot play scene no. ${message.scene} since it has not been recorded yet.`);
 
       return;
     }
 
-    this.node.context().set("playingScene", message.scene);
+    this.playingScene = message.scene;
 
     let payload: Universes | DMXValues;
     let universe: number | undefined = undefined;
@@ -343,12 +352,11 @@ class NodeHandler {
   }
 
   protected handleReset(message: MessageIn): void {
-    // TODO
     const resetScene = (scene: number) => {
-      const data: Scene | null = this.node.context().get(`scene-${scene}`) as Scene | null;
+      const data: Scene | undefined = this.scenes[scene];
 
-      if (this.node.context().get("playingScene") === scene) {
-        this.node.context().set("playingScene", null);
+      if (this.playingScene === scene) {
+        this.playingScene = null;
 
         this.node.status({
           fill: "green",
@@ -381,22 +389,18 @@ class NodeHandler {
         }
       }
 
-      this.node.context().set(`scene-${scene}`, undefined);
+      delete this.scenes[scene];
     };
 
     if (message.scene) {
       resetScene(message.scene);
     } else {
-      this.node
-        .context()
-        .keys()
-        .forEach((key) => {
-          const matches = key.match(/^scene-(\d+)/);
-          if (matches !== null) {
-            resetScene(parseInt(matches[1], 10));
-          }
-        });
+      Object.keys(this.scenes).forEach((key) => {
+        resetScene(parseInt(key, 10));
+      });
     }
+
+    this.store.save(this.scenes);
   }
 }
 
@@ -404,6 +408,7 @@ export default (RED: NodeAPI): void => {
   RED.nodes.registerType("scene-controller", function (this: Node<Config>, config: Config) {
     RED.nodes.createNode(this, config);
 
-    new NodeHandler(this, config);
+    const baseDir = RED.settings.userDir ?? process.cwd();
+    new NodeHandler(this, config, new SceneStore<Scene>(baseDir, this.id));
   });
 };

From ff8af6bdfbc18f7b250e127c96ca9c9dec770e9d Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 10:26:14 +0200
Subject: [PATCH 20/22] Ship dedicated node icons

Replace the shared Font Awesome lightbulb (used for both the in and out
node) and the scene controller's list icon with three purpose-drawn SVGs:
an inbound and outbound signal arrow for the receiver and sender and a set
of faders for the scene controller. The node colour is unchanged; the icons
ship in an icons directory that Node-RED picks up.
---
 dist/nodes/sacn-in/sacn-in.html                   |  2 +-
 dist/nodes/sacn-out/sacn-out.html                 |  2 +-
 dist/nodes/scene-controller/scene-controller.html |  2 +-
 icons/sacn-in.svg                                 |  7 +++++++
 icons/sacn-out.svg                                |  7 +++++++
 icons/scene-controller.svg                        | 10 ++++++++++
 package.json                                      |  2 +-
 src/nodes/sacn-in/init.ts                         |  2 +-
 src/nodes/sacn-out/init.ts                        |  2 +-
 src/nodes/scene-controller/init.ts                |  2 +-
 10 files changed, 31 insertions(+), 7 deletions(-)
 create mode 100644 icons/sacn-in.svg
 create mode 100644 icons/sacn-out.svg
 create mode 100644 icons/scene-controller.svg

diff --git a/dist/nodes/sacn-in/sacn-in.html b/dist/nodes/sacn-in/sacn-in.html
index 7a7936b..aae65de 100644
--- a/dist/nodes/sacn-in/sacn-in.html
+++ b/dist/nodes/sacn-in/sacn-in.html
@@ -268,7 +268,7 @@ <h3>References</h3>
         inputs: 1,
         outputs: 1,
         paletteLabel: "sACN in",
-        icon: "font-awesome/fa-lightbulb-o",
+        icon: "sacn-in.svg",
         label: function () {
             return this.name || `sACN in · U${this.universe}`;
         },
diff --git a/dist/nodes/sacn-out/sacn-out.html b/dist/nodes/sacn-out/sacn-out.html
index b5e05b1..9da8b1a 100644
--- a/dist/nodes/sacn-out/sacn-out.html
+++ b/dist/nodes/sacn-out/sacn-out.html
@@ -209,7 +209,7 @@ <h3>References</h3>
         inputs: 1,
         outputs: 0,
         paletteLabel: "sACN out",
-        icon: "font-awesome/fa-lightbulb-o",
+        icon: "sacn-out.svg",
         label: function () {
             return this.name || `sACN out · U${this.universe}`;
         },
diff --git a/dist/nodes/scene-controller/scene-controller.html b/dist/nodes/scene-controller/scene-controller.html
index 7081ef4..201436a 100644
--- a/dist/nodes/scene-controller/scene-controller.html
+++ b/dist/nodes/scene-controller/scene-controller.html
@@ -94,7 +94,7 @@ <h3>References</h3>
         inputs: 1,
         outputs: 1,
         paletteLabel: "Scene-Controller",
-        icon: "font-awesome/fa-list-ol",
+        icon: "scene-controller.svg",
         label: function () {
             return this.name || "Scene-Controller";
         },
diff --git a/icons/sacn-in.svg b/icons/sacn-in.svg
new file mode 100644
index 0000000..829e4fe
--- /dev/null
+++ b/icons/sacn-in.svg
@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+  <g fill="#222222">
+    <rect x="15" y="4" width="3" height="16" rx="1"/>
+    <rect x="20" y="4" width="3" height="16" rx="1"/>
+    <path d="M2 10.5h6V7l5 5-5 5v-3.5H2z"/>
+  </g>
+</svg>
diff --git a/icons/sacn-out.svg b/icons/sacn-out.svg
new file mode 100644
index 0000000..7b5367c
--- /dev/null
+++ b/icons/sacn-out.svg
@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+  <g fill="#222222">
+    <rect x="1" y="4" width="3" height="16" rx="1"/>
+    <rect x="6" y="4" width="3" height="16" rx="1"/>
+    <path d="M11 10.5h6V7l5 5-5 5v-3.5h-6z"/>
+  </g>
+</svg>
diff --git a/icons/scene-controller.svg b/icons/scene-controller.svg
new file mode 100644
index 0000000..3ea7e92
--- /dev/null
+++ b/icons/scene-controller.svg
@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+  <g fill="#222222">
+    <rect x="4" y="3" width="2" height="18" rx="1"/>
+    <rect x="11" y="3" width="2" height="18" rx="1"/>
+    <rect x="18" y="3" width="2" height="18" rx="1"/>
+    <rect x="2" y="6" width="6" height="3" rx="1.5"/>
+    <rect x="9" y="14" width="6" height="3" rx="1.5"/>
+    <rect x="16" y="9" width="6" height="3" rx="1.5"/>
+  </g>
+</svg>
diff --git a/package.json b/package.json
index 9c7b24d..ac37aab 100644
--- a/package.json
+++ b/package.json
@@ -55,7 +55,7 @@
   "files": [
     "dist",
     "examples",
-    "resources",
+    "icons",
     "LICENSE",
     "README.md"
   ]
diff --git a/src/nodes/sacn-in/init.ts b/src/nodes/sacn-in/init.ts
index ebdecd2..2c5607f 100644
--- a/src/nodes/sacn-in/init.ts
+++ b/src/nodes/sacn-in/init.ts
@@ -119,7 +119,7 @@ const def: EditorNodeDef<Defaults> = {
   inputs: 1,
   outputs: 1,
   paletteLabel: "sACN in",
-  icon: "font-awesome/fa-lightbulb-o",
+  icon: "sacn-in.svg",
   label: function () {
     return this.name || `sACN in · U${this.universe}`;
   },
diff --git a/src/nodes/sacn-out/init.ts b/src/nodes/sacn-out/init.ts
index 8ee773c..58a50a0 100644
--- a/src/nodes/sacn-out/init.ts
+++ b/src/nodes/sacn-out/init.ts
@@ -114,7 +114,7 @@ const def: EditorNodeDef<Defaults> = {
   inputs: 1,
   outputs: 0,
   paletteLabel: "sACN out",
-  icon: "font-awesome/fa-lightbulb-o",
+  icon: "sacn-out.svg",
   label: function () {
     return this.name || `sACN out · U${this.universe}`;
   },
diff --git a/src/nodes/scene-controller/init.ts b/src/nodes/scene-controller/init.ts
index cb43dc0..a845323 100644
--- a/src/nodes/scene-controller/init.ts
+++ b/src/nodes/scene-controller/init.ts
@@ -21,7 +21,7 @@ const def: EditorNodeDef<Defaults> = {
   inputs: 1,
   outputs: 1,
   paletteLabel: "Scene-Controller",
-  icon: "font-awesome/fa-list-ol",
+  icon: "scene-controller.svg",
   label: function () {
     return this.name || "Scene-Controller";
   },

From 89794bd3f09e1e75154fade838473e4764c7f139 Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 10:27:58 +0200
Subject: [PATCH 21/22] Re-enable the strict no-unsafe lint rules

The configuration switched off every no-unsafe rule and no-explicit-any.
The code no longer needs that: it uses explicit types and guards rather
than any, so turning the rules back on passes cleanly and keeps future
unsafe access from slipping in. no-non-null-assertion stays off, as the
scene parser still relies on a few asserted values.
---
 eslint.config.mjs | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/eslint.config.mjs b/eslint.config.mjs
index adce8f7..46f22d7 100644
--- a/eslint.config.mjs
+++ b/eslint.config.mjs
@@ -49,13 +49,7 @@ export default [{
   rules: {
     "@typescript-eslint/no-restricted-types": "error",
 
-    "@typescript-eslint/no-explicit-any": 0,
     "@typescript-eslint/no-non-null-assertion": 0,
-    "@typescript-eslint/no-unsafe-argument": 0,
-    "@typescript-eslint/no-unsafe-assignment": 0,
-    "@typescript-eslint/no-unsafe-call": 0,
-    "@typescript-eslint/no-unsafe-member-access": 0,
-    "@typescript-eslint/no-unsafe-return": 0,
 
     "@typescript-eslint/no-unused-vars": ["error", {
       argsIgnorePattern: "^_",

From 857e50f4f8e166a244b883b26a6f3defa603bbd1 Mon Sep 17 00:00:00 2001
From: Florian Gail <gail@zeiler-technik.de>
Date: Sun, 12 Jul 2026 10:29:08 +0200
Subject: [PATCH 22/22] Document the new node options in the readme

List the value scale for all three nodes, the blank-on-stop option for the
sender, and note that recorded scenes are now persisted to disk.
---
 README.md | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 847b808..5f234f3 100644
--- a/README.md
+++ b/README.md
@@ -38,6 +38,7 @@ This node can be used to read one or multiple universes sent by sACN.
 | trigger    | Controls when a message is emitted: only on change, on every received packet, or on change plus a cyclic keepalive re-emit.    | `changes`, `always`, `interval`                                | `changes`                    | yes       |
 | interval   | Keepalive interval in milliseconds for the `interval` trigger; the full universe is re-emitted when no change arrives in time. | `\d+`                                                          | `1000`                       | no        |
 | clearOnUniverseChange | When the observed universe is switched at runtime, emit a full universe of zeros until real data for the new universe arrives. | `true`, `false`                                     | `false`                      | no        |
+| values     | Emit channel values as a percentage (0–100) or as raw DMX values (0–255).                                                     | `percent`, `absolute`                                          | `percent`                    | yes       |
 | IP-address | IP-Address of the network-interface that should be used for reading from sACN.                                                | `\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\` (_any valid ip-address_) | _empty_                      | no        |
 | port       | The network port which should be used for reading sACN.                                                                       | `\d+`                                                          | _empty_ (defaults to `5568`) | no        |
 
@@ -74,6 +75,8 @@ This node can be used to send one universe using sACN.
 | source-name | The name for the sACN-sender that should be displayed within the network. | _any string below 50 characters_                               | `Node-RED`                   | yes       |
 | speed       | Defines the frequency for sending sACN-packages                           | `once (0Hz)`, `24Hz`, `27Hz`, `30Hz`, `40Hz`, `44Hz`           | `0Hz`                        | yes       |
 | priority    | The priority that should be used for the sACN-sender.                     | `\d+` (`1` to `200`)                                           | `100`                        | yes       |
+| values      | Interpret the payload as a percentage (0–100) or as raw DMX values (0–255). | `percent`, `absolute`                                         | `percent`                    | yes       |
+| blank-on-stop | Send an all-zero frame before closing so receivers go dark on stop.     | `true`, `false`                                                | `false`                      | no        |
 | IP-address  | IP-Address of the network-interface that should be used for sending sACN. | `\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\` (_any valid ip-address_) | _empty_                      | no        |
 | port        | The network port which should be used for reading sACN.                   | `\d+`                                                          | _empty_ (defaults to `5568`) | no        |
 
@@ -89,7 +92,11 @@ This node can be used to record scenes and play them afterwards.
 
 #### Parameters:
 
-This node has no configuration parameters; its behaviour is controlled entirely through the incoming message.
+| Parameter | Description                                                                    | Possible Values       | Default Value | Mandatory |
+| --------- | ------------------------------------------------------------------------------ | --------------------- | ------------- | --------- |
+| values    | Interpret channel values as a percentage (0–100) or as raw DMX values (0–255). | `percent`, `absolute` | `percent`     | yes       |
+
+Recorded scenes are stored on disk (in a `sacn-scenes` directory inside the Node-RED user directory) and survive a restart.
 
 #### Expected input: