Added OSC

docs/OSC_CONTROL.md

@@ -0,0 +1,65 @@
+# OSC Control
+
+Video Shader Toys can listen for local OSC messages and map them onto shader layer parameters.
+
+## Configuration
+
+Set the UDP port in `config/runtime-host.json`:
+
+```json
+{
+  "oscPort": 9000
+}
+```
+
+Set `oscPort` to `0` to disable the OSC listener.
+
+## Address Pattern
+
+Send OSC messages to:
+
+```text
+/VideoShaderToys/{LayerNameOrID}/{ParameterNameOrID}
+```
+
+Examples:
+
+```text
+/VideoShaderToys/layer-1/brightness
+/VideoShaderToys/VHS/intensity
+/VideoShaderToys/TemporalLowFPS/frameRate
+```
+
+Layer keys are resolved against:
+
+- Layer ID, such as `layer-1`
+- Shader package ID, such as `vhs`
+- Shader display name, such as `VHS`
+
+Parameter keys are resolved against:
+
+- Parameter ID from `shader.json`
+- Parameter label from `shader.json`
+
+Matching is exact first. If that fails, names are compared in a simplified form that ignores spaces, underscores, hyphens, and casing. For live control, prefer stable IDs where possible.
+
+## Values
+
+The listener accepts one OSC argument per message:
+
+- `f`: float
+- `i`: integer
+- `s`: string
+- `T` / `F`: boolean true/false
+
+Values are validated with the same shader parameter rules used by the REST API. Invalid values or unknown addresses are ignored.
+
+## Network
+
+The listener binds to localhost only:
+
+```text
+127.0.0.1:<oscPort>
+```
+
+This keeps the control surface local to the machine running Video Shader Toys.

docs/openapi.yaml

@@ -359,6 +359,8 @@ components:
       properties:
         serverPort:
           type: number
+        oscPort:
+          type: number
         autoReload:
           type: boolean
         maxTemporalHistoryFrames: