Settings Window Reference

Last updated 28 July 2026

Settings Window Reference

The Settings window contains all global and per-user configuration for Backstage. Open it from the View menu. Settings are grouped into collapsible sections under two headings: Global Settings (saved per-server, shared across all users and projects) and User Interface Settings (saved per-user, local to one UI session).

[USER-ACTION-REQUIRED: Attach a screenshot of the Settings window here]


Global Settings

AI

AI Provider and Task Settings

Configure connections to LLM providers for the built-in AI Assistant. Backstage supports both local and cloud providers.

Setting

Description

Values / Range

Server URL

Base URL of the LLM provider endpoint.

URL string

API Key

Authentication key for cloud providers. Not required for local Ollama.

String (masked)

Model

Model to use. Populated after a successful connection.

Dropdown (fetched from provider)

Supported providers: Ollama (local), Ollama Cloud, OpenAI, Anthropic, Mistral. A colored indicator shows connection state: green = connected, red = disconnected.

Tasks: Assign a provider and model to each AI task (Chat, Vision, Orchestration, Image Generation). Image Generation also includes local Stable Diffusion settings with model download, VRAM management (Keep CLIP on CPU, Keep VAE on CPU, VAE Tiling), and default generation parameters (Sampling Steps 1–50, CFG Scale 1.0–20.0).

Asset Defaults

Colorspace and General Asset Defaults

Default color and fit-mode settings applied to assets without explicit metadata.

Colorspace:

Setting

Description

Values / Range

Color Primaries

Default color primaries for assets without embedded metadata.

BT.601, BT.709, BT.2020, DCI-P3, Adobe RGB, Manual

Color Transfer

Default transfer function (EOTF) for assets without embedded metadata.

Gamma, sRGB, ST.2084 (PQ), HLG, Log, Linear

General:

Setting

Description

Values / Range

Aspect Ratio Correction

Default fit mode when asset and destination aspect ratios differ.

Dropdown (fit modes)

Backup

Project Backup Settings

Setting

Description

Values / Range

Backup Path

Directory where automatic project backups are stored.

Folder path (browse)

Number of backups

How many backup copies to retain.

Integer

Capture Input

Capture Card Settings

Setting

Description

Values / Range

Receive Latency (frames)

Capture card receive latency in frames. Higher values reduce dropped frames but increase delay.

1.0–4.0 (default: configurable per card)

Latency offset for frame-blending

Additional latency offset when frame blending is active on capture inputs.

0.0–5.0

Audio buffer size (milliseconds)

Buffer size for capture card audio input.

1–500 ms

Synchronization Tolerance

Tolerance window for capture frame synchronization timing.

1.0–16.0 ms

Clock

Clock and PTP Settings

Master clock configuration including PTP synchronization for multi-server setups.

Setting

Description

Values / Range

Time

Current Backstage clock time (read-only).

Read-only

ASIO clock

Select an ASIO audio device to drive the system clock. Only ASIO output devices are listed.

Dropdown (ASIO devices)

Clock reset

Reset the global clock to zero.

Button

PTP Settings — PTP (Precision Time Protocol, IEEE 1588v2) synchronization for multi-server setups. Two PTP instances are available: Clock (primary) and Bridge (secondary, for bridging between PTP domains).

Setting

Description

Values / Range

Master elevation

Require elevated (admin) privileges before this instance can become PTP master.

Checkbox

NIC

Network interface for PTP traffic. Can use the Sync NIC or a specific adapter.

Dropdown (NICs + Sync NIC)

BMCA

Enable Best Master Clock Algorithm. The PTP network automatically elects a grandmaster.

Checkbox (Clock only)

Domain

PTP domain number. Instances on different domains do not synchronize.

0–255

Timing

PTP timing profile. Determines announce, sync, and delay request intervals.

AES67, PTP1588v2, SMPTE, Backstage

Priority 1 / Priority 2

BMCA priority values. Lower values give higher priority when electing a grandmaster.

0–255 (visible when BMCA is on)

E2E

Use End-to-End delay measurement (vs Peer-to-Peer).

Checkbox

Relative

Use relative offsets rather than absolute time (slave mode only).

Checkbox (Clock only, BMCA off)

The Stats sub-section (visible when a PTP clock is active) shows: clock identity, state (master/slave/listening), grandmaster ID, drift, local delay, mean delay, and time since last update. A Clock jump log records any time discontinuities detected in the PTP clock.

CPU Affinity

CPU Affinity Settings

Setting

Description

Values / Range

Automatic

Let Backstage manage CPU affinity assignments automatically.

Checkbox (default: on)

Process Affinity

Select which CPU cores the Backstage process may use. Disabled when Automatic is on.

Per-core checkboxes

Thread Affinities

Assign specific cores to individual thread types. Select the thread type, then toggle cores.

Thread type dropdown + per-core checkboxes

DMX

DMX / ArtNet Output Defaults

Setting

Description

Values / Range

Bind to interface

Default network interface for ArtNet output. "None" uses the OS default.

Dropdown (NICs) / None

Send on change only

Only send ArtNet frames when DMX values change, reducing network traffic.

Yes / No

GPU Affinity

GPU Queue Affinity Settings

Assign GPU queue tasks to specific hardware queues. Shows available and allocated queues for Graphics, Compute, Transfer, and Video Decode.

Changes to GPU Affinity require a software restart.

Setting

Description

Values / Range

Automatic

Let Backstage assign GPU queue affinities automatically.

Checkbox (default: on)

GPU Task

Select the GPU task to configure when Automatic is off.

Dropdown (task types)

Queue assignment

Toggle which hardware queues the selected task may use.

Per-queue checkboxes

GPU Memory

GPU Memory Allocation Settings

Setting

Description

Values / Range

Mode

GPU memory allocation strategy. Realtime 3D keeps resources ready for fast scene changes. Media Server optimizes for linear playback.

Realtime 3D / Media Server / Auto

Pool Size (%)

Percentage of total GPU memory reserved for the playback buffer pool.

5–80%

Pool Block Size (MB)

Size of each individual allocation block in the GPU memory pool.

Integer (MB) / Auto

Locale

Unicode Script Support

Enable or disable Unicode script support for the UI font renderer. Enable additional scripts if your project uses text in languages beyond Latin (e.g. CJK, Arabic, Cyrillic).

Setting

Description

Values / Range

Script checkboxes

Toggle individual Unicode script blocks to include in the font atlas.

Per-script checkboxes

Logging

Logging Configuration

Setting

Description

Values / Range

Enable Logging

Master toggle for all logging.

Checkbox

Log View: Minimum Level (dropdown), Maximum entries (integer).

File Log: Enable file logging (checkbox), Minimum Level (dropdown).

Syslog: Enable Syslog logging (checkbox), Minimum Level (dropdown), Target IP (string), Target Port (integer).

WHEA: Enable Kernel Error Logging (checkbox) — logs Windows Hardware Error Architecture events for diagnosing GPU/memory faults. Requires restart.

Maintenance

Data Patrol and Data Refresh

Data Patrol: Background task that periodically reads and rewrites stored media to detect and prevent silent data corruption (bit rot).

Setting

Description

Values / Range

Enable Data Patrol

Turn the background rewrite task on or off.

Checkbox

MB/s

Bandwidth limit for the rewrite task.

Integer (MB/s) / Auto

Days

Target days (24h operation) for one full patrol cycle. Visible when MB/s is Auto.

Integer / Auto

Data Refresh: Show as Option in Assets (checkbox), Run Endless (checkbox), Read All (button), Rewrite All (button).

Media Playback

Media Playback Settings

Setting

Description

Values / Range

Media Root

Root directory for media files. Backstage resolves relative asset paths against this folder.

Folder path (browse)

Align start to V-Sync

Synchronize media playback start to the next V-Sync signal.

Checkbox

Align every loop start to V-Sync

Re-align to V-Sync on every loop iteration. Visible when Align start is on.

Checkbox

Enable reverse playback

Allow backward playback for image sequences and mono/stereo audio. Requires scene reload.

Checkbox

Sub-sections Audio and Video contain detailed playback tuning. See the Audio and Video sub-sections below.

Audio > Output groups — Lists active audio output groups. Each can be marked persistent. Click a group name to navigate to its configuration.

Audio > Audio devices — Lists all detected audio devices. Use Rescan audio devices to re-detect hardware.

Audio > Behaviour — Playback tempo adjustment, mixer threads (1–16), playback buffer, splitter buffer, stream/mixer ramps, non-stop output/ASIO. Most require scene reload.

Video > Image Sequence: Number of pre-buffered frames, Playback buffer size, Playback buffering queue grow limit (2–buffer size), MB/s per Core (minimum 50).

Video > Compressed Video: Pre-buffered frames, Playback buffer size, Max Frame-to-Time Deviation (0.5–1.0), Max AV Sync Deviation (0–2000 ms). Hardware Acceleration per codec (H264, H265, AV1, VP9). Compressed Settings (Clamp to Border Sampling Mode, Copy Frames After Decode). Vulkan Video (Enable Decoder Warmup, Warmup Frames).

Video > Advanced: Default frame blending type, frame blending frame count, Smooth stream time, Max pre-buffer GPU memory usage (0–100%), Host to device transfer mode (Auto), Allocate GPU memory on each physical device (Auto).

Network

Network Synchronization Settings

Setting

Description

Values / Range

Node sync NIC

Network interface for node editor synchronization (multicast). All sync traffic between Backstage instances uses this interface.

Dropdown (NICs)

Sync UDP size limit

Maximum UDP message size for sync traffic. Messages exceeding this are sent via a different transport.

1–65507 bytes

NDI

NDI Settings

Setting

Description

Values / Range

Receive Buffer

Minimum receive latency for NDI inputs (in frames).

1.0–3.5

Disconnect unused

Automatically disconnect NDI sources not routed to any output. Disabling requires scene reload.

Checkbox

Exclude "Remote Connection" sources

Filter out NDI Remote Connection sources from the source list.

Checkbox

Enable NDI Input Slots (HTTP / REST Port 8080)

Enable the REST API server for NDI source routing. Shows Username/Password when enabled.

Checkbox

Enable Device Routing Window

Enable the NDI device routing matrix for remote device management.

Checkbox

HTTP session threads

Number of concurrent HTTP session threads (visible when Device Routing is on).

2–64

Output Monitoring

NDI Output Monitoring Settings

Setting

Description

Values / Range

Scale %

Resolution scale of the NDI monitoring stream.

1–100%

Framerate

Frame rate of the monitoring stream.

1–240 fps

NDI Group Name

NDI group used for the monitoring stream.

String

Press Apply after changing monitoring settings.

Output Rendering

Output Presentation and Exclude Settings

Presentation:

Setting

Description

Values / Range

Present API

Graphics API used for output presentation.

Dropdown / Auto

Output Rendering

Synchronization mode for output rendering before swapchain present.

Dropdown

Output Bit Depth

Override the bit depth for all outputs set to Auto. Force 8-bit for performance or 10-bit for color precision.

Auto / 8 Bit / 10 Bit

Wait for v-sync

V-sync wait mode for Vulkan presentation. Only visible when Present API is Vulkan.

Dropdown / Auto

Exclude:

Setting

Description

Values / Range

Keywords

Comma-separated, case-insensitive substrings. A GPU output is hidden if any keyword matches its adapter name or friendly name. Restart required.

String (default: aspeed,basic,kvm-via-ip,virtual)

The Exclude Keywords filter hides unwanted GPU outputs such as BMC iGPUs, Microsoft Basic Render drivers, KVM-over-IP adapters, and virtual IndirectDisplay outputs. Changes require a restart of Backstage.

Role

Role and Replicate Settings

Configure how this server participates in a multi-server setup.

Setting

Description

Values / Range

Role

Startup role for this server. Primary is standalone. Backup syncs from a Primary.

Primary / Backup / Leader / Follower

Primary IP

IP address of the primary server to sync from. Visible for Backup/Follower roles. Restart required.

IP address string

Replication scope

What to replicate. Mirror drive copies an entire drive. Mirror folder copies specific folders. Active assets copies only assets used in the current scene.

Mirror drive / Mirror folder / Active assets (default)

Delete stale files

Remove files on the backup that are no longer present on the primary. Only for drive/folder scope.

Checkbox (default: off)

Block Replicators

Prevent replicators from pulling files from this machine.

Checkbox (default: off)

When in Backup role, additional options appear: Sync Mode (Event-driven / Manual) and a Sync Now button. The section also shows the list of connected replicators with last-sync timestamps.

Startup

Startup Settings

Setting

Description

Values / Range

Autoload last scene

Automatically load the most recently opened project at startup.

Checkbox

Startup file

Load a specific project file at startup. Disabled when Autoload last scene is on.

Checkbox + file path

Wait entire scene loaded

Delay auto-starting sequences until all assets and outputs are fully loaded.

Checkbox

System

System Global Settings

Setting

Description

Values / Range

Allow system go to sleep

Allow the OS to put the server into sleep mode. Disable for always-on installations.

Checkbox

Remote User-Interface: Only transfer frames with visible changes

Reduce bandwidth for remote/streamed UI sessions by only sending frames when the UI changes.

Checkbox

Timing

Timing and Sleep Settings

Advanced timing parameters for schedulers and subsystem sleep intervals.

Sync Timeouts: Timecode timeout (microseconds, minimum 100000).

Sleep Times: Scheduler sleep (ns), System scheduler sleep (ns), Scheduler sync (ns), ASIO ctrl sleep (ns). All minimum 0.

Lazy Loading: Lazy Load Prepare Time (ms) — how far in advance lazy-loaded assets begin loading.

Virtual Desktop

Virtual Desktop Capture Settings

Latency window settings for the IDD (Indirect Display Driver) virtual monitor capture pipeline.

Setting

Description

Values / Range

Latency window min (frames)

Below this latency, a frame repeat is issued to avoid underrun.

0.0–4.0

Latency window width (frames)

Above min + this offset, a frame skip is issued to reduce latency buildup.

0.0–5.0

Webserver

Web Server Settings

Setting

Description

Values / Range

Enable (HTTP Port 80)

Start the built-in web server on port 80 for the web-based remote interface.

Checkbox


User Interface Settings

Calibration

Calibration Settings

Setting

Description

Values / Range

Always Orthogonalize

Automatically orthogonalize projector calibration results.

Checkbox

Display Calibration Markers on geometry

Show imported calibration marker points on surfaces in the 3D viewport.

Checkbox

User Interface

User Interface Display and Navigation Settings

Setting

Description

Values / Range

Reset Camera View

Reset the 3D viewport camera to its default position and orientation.

Button

Show Navigation Overlay

Show or hide the navigation orientation cube in the Scene View.

Checkbox

Navigation Overlay Size

Size of the navigation overlay widget.

50–200

Display mode

UI color theme or display mode.

Dropdown

Synchronize UI render to v-sync

Synchronize the UI rendering loop to the monitor's v-sync signal.

Checkbox

V-Sync UI Render Timing

Target percentage of the v-sync interval for UI render timing. Visible when sync is on.

0–100%

Open Inspector Popup after Output creation

Automatically open the Inspector popup when a new output is created.

Checkbox

Show Transient

Show transient (temporary, system-created) assets and sequences in the panels.

Checkbox

Paths

File System Path Settings

Configure default file system paths for various resource types. Each path has a Last used checkbox — when enabled, Backstage remembers the last folder browsed for that category.

Path

Description

Assets

Default directory for asset files.

File Upload

Upload destination for remote file transfers.

Audio

Default directory for audio files.

Models

Default directory for 3D model files (.obj).

Textures

Default directory for texture files.

AC FH Meshes

Directory for Auto Calibration meshes.

AC Scaleable

Directory for Scalable Display auto-calibration files.

Blend Masks

Directory for blend mask images.

Screenshots

Directory for screenshot output.

Saves

Directory for project save files. Locked when set by an environment variable.

XML

Directory for XML configuration files.


Tips

  • Many settings labeled Auto let Backstage determine the optimal value for your hardware. Start with Auto and only switch to manual if you encounter a specific issue.

  • Settings that say "Requires software restart" or "Requires scene reload" do not take effect immediately. The note appears in a tooltip when you hover over the setting.

  • The MB/s per Core value under Image Sequence determines how many CPU cores Backstage allocates for disk IO. Set it to match your storage subsystem's sustained per-core throughput.

  • For multi-server installations, configure Node sync NIC and PTP Clock NIC to use the same dedicated synchronization network.

  • The Data Patrol feature is important for long-running permanent installations. It reads and rewrites media in the background to detect bit rot before it causes playback artifacts.

  • All Global Settings are saved to the system configuration file and apply to every user session. User Interface Settings are per-user and saved to a separate config file.

B7 Settings — Recommended settings for B7 Series servers (AMD WX9100 / DX11).

B8 Settings — Recommended settings for B8 Series servers (NVIDIA RTX A6000).

GPU Output — GPU Output reference (bit depth, sync, color settings per output).

Performance Overview — Performance Overview window for real-time performance metrics.

Color Spaces, Color Primaries, and Transfer Functions — Color Spaces, Color Primaries, and Transfer Functions reference.