Settings¶

Configure recording defaults, destinations, NMOS, and logging. Select the Settings icon from source selection or the capture view.

Choose a page in the sidebar, then select Done to save changes. Cancel, the dialog's close button, or Escape discards unsaved field changes.

Recording defaults apply to subsequent captures. Configure them before starting the next recording.

Recording¶

* Affects monitoring, not the quality of the recorded JPEG XS essence.

Destination¶

For example, {label}_{date}_{time} can produce CameraA_2026-10-01_143000.mxf. Recordings use the .mxf extension. Existing files are not overwritten: a sequence number is advanced or appended to choose an unused filename. An empty template uses {label}_{date}T{time}Z.

The current settings preview uses sample values and incorrectly shows a .mkv extension. Actual recordings are MXF. Use Stream info > Recording to check the capture's output path.

NMOS¶

NMOS provides source discovery and receiver connection control. Coordinate these settings with your network administrator.

For a manually configured registry:

1. Enable NMOS and select the network interface.
2. Set Registry discovery to Manual.
3. Enter the registry host and port supplied by your administrator.
4. Select Done, then check Available streams.

Scroll down to reach the network and registry fields. Changes apply only after Done. The buttons with the globe icon launches a browser at the local Node or Connection API using the displayed port; opening a link does not save changes or start an API listener.

Firewall and Windows permissions¶

Local and network firewall settings, especially on Windows, can prevent the NMOS receiver node from being discovered, discovering other nodes, or receiving streams entirely. Ask your network administrator to check the active network profile and rules for discovery traffic, the Node and Connection APIs, communication with the registry, and incoming stream traffic on the selected network interface. The installer configures HTTP URL reservations but does not open firewall ports; network access may require separate firewall rules.

Reserving HTTP URLs for standard users on Windows¶

The NMOS node runs a web server for its IS-04 Node and IS-05 Connection APIs. During an NMOS-enabled Windows installation, the installer prompts for the Node and Connection ports (defaults: 3212 and 3215) and creates machine-wide HTTP URL reservations for Everyone. The installer requires elevation to create these reservations; after setup, standard users can run joinXS Recorder without launching it as an administrator.

The installer saves the selected ports as machine-wide application defaults. Existing per-user NMOS settings take precedence, so check Settings > NMOS and make sure the actual Node port and Connection port match the reservations. If a reservation already exists with conflicting permissions, the installer does not replace it and reports an error; ask an administrator to inspect the existing reservation.

Changing either port later in Settings > NMOS does not update its reservation. Ask an administrator to reserve the new port with the commands below, or rerun the installer and select ports that match the settings. Rerunning the installer does not change existing per-user settings, so verify the configured values before using NMOS.

Setup and uninstallation leave existing reservations in place because other applications or user profiles may still need them. Ask an administrator to review unused reservations before removing them.

1. Check the Node port and Connection port in Settings > NMOS and save any changes with Done.

2. Ask an administrator to open Command Prompt with Run as administrator and run the following commands for the default ports:

   netsh http add urlacl "url=http://*:3212/" "sddl=D:(A;;GX;;;S-1-1-0)"
   netsh http add urlacl "url=http://*:3215/" "sddl=D:(A;;GX;;;S-1-1-0)"
   

   Replace 3212 and 3215 with the configured ports if they differ. Registry port identifies the remote Registration API; it is not a local listener and does not need a reservation on the Recorder computer.

3. Restart joinXS Recorder as the standard user. If either API port changes later, ask an administrator to reserve the new URL before using it.

To inspect existing reservations, run netsh http show urlacl. If a reservation already exists for a URL, ask the administrator to check its permissions rather than deleting or replacing it blindly.

Advanced¶

Use this page to configure logs and locate them when troubleshooting.

Select Done to apply logging changes. Review logs for sensitive information before sharing them with support.

License¶

Shows the current state: Active, Demo, Expired, or Not activated, with an offline indication where applicable. A valid offline license also displays the licensee and subscription period.

The available actions depend on the licensing mode. See Licensing for activation, import, removal, and logout instructions. The machine identifier can be copied for licensing support.

About¶

Shows the application version and build, plus the Qt, GStreamer, and gstjxs versions. Include the application version and build when contacting support.

Open HTML manual opens the installed manual in your browser when the manual is included in the installation; otherwise the button is disabled. Open third-party licenses opens the notices folder when available.