Settings Window Reference
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
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
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
|
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
|
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
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
|
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
|
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
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
|
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
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
|
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: 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
|
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
|
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
|
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
|
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
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: |
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
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
|
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
|
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
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
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
|
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
|
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
|
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
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.
Related
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.
