Preview
Displays video and audio streams in real-time for monitoring via WebRTC, JPEG or MoQ (WebTransport)
Component Configuration
| Option | Description | Required | Environment override |
|---|---|---|---|
id |
A unique identifier for the component instance |
✓ |
|
displayName |
The name shown in the Studio UI of this component |
✓ |
|
previewMode |
How to display the video. MoQ requires the global MoQ Preview listener (cert + key) to be configured. The browser must trust the cert (real CA, or use serveFingerprint with a self-signed cert via mkcert). (default: "image") |
✗ |
|
showPreview |
Show video preview (default: true) |
✗ |
|
jitterBuffer |
Configure the buffer to smooth outgoing data. Leave empty to use global latency profile default. (default: {}) |
✗ |
|
notes |
Additional notes about this component |
✗ |
Jitter Buffer
| Option | Description | Required |
|---|---|---|
bufferDelayMs |
How many milliseconds in the jitter buffer. Leave empty to use the global latency profile default. |
✗ |
Ice Servers
Environment override: GLOBAL_ICE_SERVERS (sets this global option as a whole).
| Option | Description | Required |
|---|---|---|
url |
URL of the STUN/TURN server (with turn:/stun: prefix) as accessed by Norsk Studio |
✓ |
reportedUrl |
Optional URL of the STUN/TURN server as accessed by the client (if different to the above) |
✗ |
username |
Optional username |
✗ |
credential |
Optional password |
✗ |
Moq Preview
Environment override: GLOBAL_MOQ_PREVIEW (sets this global option as a whole).
| Option | Description | Required |
|---|---|---|
quicServerPort |
QUIC listener port for native MoQT subscribers (optional — only needed for non-browser clients) |
✗ |
webTransportPort |
WebTransport listener port for browser MoQ players. Defaults to 4443. (default: 4443) |
✗ |
publicHost |
The hostname browsers reach MoQ on, when it is not the public hostname (PUBLIC_URL_PREFIX): e.g. a host whose web UI is reached over an SSH tunnel while its media ports are public. Applies to the listener above and, when no Relay public URL is set, to the relay. |
✗ |
quicServerCert |
TLS certificate file path. If omitted, a self-signed cert is auto-generated (14-day validity, rotated every 10 days). |
✗ |
quicServerKey |
TLS private key file path. If omitted, auto-generated alongside the cert. |
✗ |
serveFingerprint |
Publishes the cert SHA-256 so the moq-js player can trust it via WebTransport's serverCertificateHashes. Defaults on. Turn it off when the certificate is CA-issued and the browser trusts it already. (default: true) |
✗ |
relayUrl |
Publish through a shared MoQ relay instead of binding a listener here. Setting this switches every MoQ component to relay mode and the ports/cert above are no longer used, so several Norsk instances on one host can share a single MoQ port. This is how NORSK reaches the relay, which behind a proxy is an internal address. |
✗ |
relayPublicUrl |
What the BROWSER connects to, if that differs from the Relay URL. Leave blank to use the public hostname (PUBLIC_URL_PREFIX) with the Relay URL's port. |
✗ |
relayNamespacePrefix |
Prepended to every namespace this instance publishes to the relay, so instances sharing one relay stay distinct. Usually the instance name. |
✗ |
relayDisableTlsVerify |
Skip TLS verification when connecting to the relay. Needed only for a relay with a self-signed certificate. (default: false) |
✗ |
Tags: preview monitor webrtc jpeg moq webtransport