Settings

Last updated 5 August 2026

Settings

The Settings window contains global and per-user configuration options for Backstage. Open it from the View menu or toggle its visibility in the menu bar.

Settings are organized into collapsible sections divided into two groups: Global Settings (saved per-server, apply to all projects and users) and User Interface Settings (per-user, apply to the local UI only).


Global Settings

AI

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

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

Which model to use for each provider. Populated automatically after a successful connection.

Dropdown (fetched from provider)

Supported providers: Ollama (local), Ollama Cloud, OpenAI, Anthropic, Mistral.

A colored status indicator shows connection state: green = connected, red = disconnected or missing API key.

Task Assignment

Assign a specific provider and model to each AI task:

Task

Description

Chat

General conversational queries.

Vision

Image analysis tasks.

Orchestration

Multi-step reasoning and tool use.

Image Generation

AI image generation (uses Stable Diffusion engine).

Asset Defaults

Default color and fit-mode settings applied to assets that do not have explicit metadata.

Colorspace

Setting

Description

Values / Range

Color Primaries

Default color primaries assigned to assets without embedded primaries.

BT.601, BT.709, BT.2020, DCI-P3, Adobe RGB, Manual (custom RGBW)

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

Settings for hardware capture card inputs (e.g. Datapath).

Setting

Description

Values / Range

Receive Latency (frames)

Capture card receive latency in frames.

1.0–4.0

Latency offset for frame-blending

Additional latency offset applied 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.

1.0–16.0 ms

Clock

Master clock configuration, including PTP synchronization.

Setting

Description

Values / Range

Time

Displays the 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 used for PTP. Can be set to the Sync NIC or a specific adapter.

Dropdown (NICs)

BMCA

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

Checkbox (Clock only)

Domain

PTP domain number. Instances on different domains do not synchronize with each other.

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 enabled)

E2E

Use End-to-End delay measurement (as opposed to Peer-to-Peer).

Checkbox

Relative

Slave relative timestamp mode. Uses relative offsets rather than absolute time.

Checkbox (Clock only, when BMCA is off)

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

CPU Affinity

Control which CPU cores Backstage uses for its process and individual thread types.

Setting

Description

Values / Range

Automatic

Let Backstage manage CPU affinity assignments automatically.

Checkbox (on by default)

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 (e.g. render, scheduler, IO). Select the thread type from the dropdown, then toggle cores.

Thread type dropdown + per-core checkboxes

DMX

ArtNet Output Defaults

Setting

Description

Values / Range

Bind to interface

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

Dropdown (NICs)

Send on change only

When enabled, ArtNet frames are only sent when values change (reduces 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.

Setting

Description

Values / Range

Automatic

Let Backstage assign GPU queue affinities automatically.

Checkbox (on by default)

GPU Task

Select the GPU task to configure.

Dropdown (GPU task types)

Queue assignment

Toggle which hardware queues the selected task may use. Disabled when Automatic is on.

Per-queue checkboxes

Changes to GPU Affinity require a software restart.

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 with a static scene.

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 within the GPU memory pool.

Integer (MB) / Auto

Locale

Scripts

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.

Per-script checkboxes

Logging

Setting

Description

Values / Range

Enable Logging

Master toggle for all logging.

Checkbox

Log View

Setting

Description

Values / Range

Minimum Level

Minimum severity shown in the Log window.

Dropdown (log levels)

Maximum entries

Number of log entries retained in the Log window.

Integer

File Log

Setting

Description

Values / Range

Enable file logging

Write log output to a file on disk.

Checkbox

Minimum Level

Minimum severity written to the log file.

Dropdown (log levels)

Syslog

Setting

Description

Values / Range

Enable Syslog logging

Send log messages to a remote syslog server.

Checkbox

Minimum Level

Minimum severity sent to syslog.

Dropdown (log levels)

Target IP

IP address of the syslog server.

IP address string

Target Port

UDP port of the syslog server.

Integer

WHEA

Setting

Description

Values / Range

Enable Kernel Error Logging

Log Windows Hardware Error Architecture (WHEA) events. Useful for diagnosing hardware faults (GPU errors, memory errors).

Checkbox

WHEA logging requires a software restart to take effect.

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 the start of media playback 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 to V-Sync is on).

Checkbox

Enable reverse playback

Allow backward playback for image sequences and mono/stereo audio files.

Checkbox

Enabling or disabling reverse playback requires a scene reload.

Audio

Output groups — Lists all active audio output groups. Each group can be marked as persistent. Click a group name to navigate to its configuration in the Outputs panel.

Audio devices — Lists all detected audio devices, grouped by type (In/Out, Output, Input, Virtual). Use the Rescan audio devices button to re-detect hardware.

Behaviour

Setting

Description

Values / Range

Playback tempo adjustment

Enable automatic tempo correction to keep audio in sync with the scheduler.

Checkbox

Playback adjustment mode

Method used for tempo correction: Tempo (pitch-preserving) or Pitch (shifts pitch).

Tempo / Pitch

Quick algorithm

Use a faster but less precise tempo adjustment algorithm.

Checkbox

Click prevention

Reduce audible clicks during tempo adjustment.

Checkbox

Tempo AA filter

Anti-aliasing filter size for tempo adjustment. Set to 0 to disable.

0, or 8–128

Mixer threads (1..16)

Number of threads used for audio mixing.

1–16

Playback buffer (ms)

Decoder playback buffer size.

≥ 10 ms

Splitter buffer (ms)

Audio splitter buffer size. Must be ≥ Playback buffer.

≥ Playback buffer ms

Async stream buffer

Async audio stream buffer size.

Integer

Stream ramps

Enable fade ramps when audio streams start/stop.

Checkbox

Mixer ramps

Enable fade ramps on mixer transitions.

Checkbox

Non-stop output

Keep audio device output running even when no audio is playing.

Checkbox

Non-stop ASIO mixers

Keep ASIO mixer outputs running continuously.

Checkbox

Most Audio Behaviour settings require a scene reload.

Video > Image Sequence

Setting

Description

Values / Range

Number of pre-buffered frames

How many frames are loaded into GPU memory ahead of playback.

Integer (≥ 0)

Playback buffer size (frames)

Number of frames the video stream buffers in advance during playback.

Integer (≥ 0)

Playback buffering queue grow limit (frames)

Maximum number of frames the buffer can grow by per render iteration.

2–Playback buffer size

MB/s per Core

Expected sustained read throughput per CPU core. Used to calculate how many cores to allocate for media IO.

Integer (≥ 50)

Video > Compressed Video

Setting

Description

Values / Range

Number of pre-buffered frames

Pre-buffer size for compressed video assets.

Integer (≥ 0)

Playback buffer size (frames)

Stream buffer size for compressed video playback.

Integer (≥ 0)

Max Frame-to-Time Deviation

Maximum allowed deviation between decoded frame time and expected time before a stream reset.

0.5–1.0

Max AV Sync Deviation

Maximum audio/video sync deviation before correction occurs.

0–2000 ms

Hardware Acceleration — Per-codec hardware decode settings. Each codec (H264, H265, AV1, VP9) can be set to CPU decoding, GPU hardware decoding, or automatic selection.

Changes to hardware decoder settings require a software restart.

Compressed Settings:Clamp to Border Sampling Mode (Dropdown) controls how compressed video is sampled at texture edges. Copy Frames After Decode (Checkbox) copies decoded frames to a separate texture after decode, freeing decoder resources faster.

Vulkan Video:Enable Decoder Warmup (Checkbox) pre-decodes a number of frames when initializing a video stream. Warmup Frames (Integer) sets how many frames to decode during warmup.

Video > Advanced

Setting

Description

Values / Range

Default frame blending type

Frame blending mode used by new video channels.

Dropdown (blending modes)

Number of frames for frame blending

Number of frames involved in skip/repaint frame blending.

Integer

Smooth stream time

Enable outlier smoothing on the scheduler time to prevent jitter-induced frame jumps.

Checkbox

Max pre-buffer GPU memory usage

Maximum percentage of GPU memory that may be used for asset pre-buffering.

0–100%

Host to device transfer mode

Method for transferring frames from CPU to GPU. Auto selects the best mode for your hardware.

Dropdown / Auto

Allocate GPU memory on each physical device

When multiple GPUs are installed, allocate playback memory on every GPU (not just the primary).

Checkbox / Auto

Network

Setting

Description

Values / Range

Node sync NIC

Network interface used 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 size are sent using 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 that are not routed to any output or channel.

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. When enabled, Username and Password fields appear.

Checkbox

Username / Password

Credentials for the REST server (visible when REST is enabled).

String

Enable Device Routing Window

Enable the NDI device routing matrix for remote device management.

Checkbox

HTTP session threads

Number of concurrent HTTP session threads for device routing (visible when Device Routing is enabled).

2–64

Disabling "Disconnect unused" requires a scene reload to reconnect previously disconnected sources.

Output Monitoring

Configure the NDI monitoring stream that mirrors the selected output.

Setting

Description

Values / Range

Scale %

Resolution scale of the monitoring stream, as a percentage of the output resolution.

1–100%

Framerate

Frame rate of the monitoring NDI 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 better performance, or 10-bit for higher color precision.

Auto / 8 Bit / 10 Bit

Wait for v-sync

V-sync wait mode for Vulkan presentation (visible only 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.

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

Use this to hide GPU outputs you never render to — management-controller display adapters, basic render drivers, KVM-over-IP adapters and virtual indirect-display outputs.

Changes to the Exclude keywords require a software restart.

Role

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

Setting

Description

Values / Range

Role

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

Primary / Backup / Leader / Follower

Primary IP

Address of the primary server to sync from (visible for Backup and Follower roles).

IP address string

Replication scope

What to replicate. Mirror drive copies an entire drive; Mirror folder copies specific folders; Active assets copies only what the current scene uses.

Mirror drive / Mirror folder / Active assets (default)

Delete stale files

Remove files on the backup that no longer exist on the primary (drive and folder scope only).

Checkbox (off by default)

Block Replicators

Prevent replicators from pulling files from this machine.

Checkbox (off by default)

In the Backup role, further options appear: Sync Mode (Event-driven / Manual) and a Sync Now button. The section also lists connected replicators with their last-sync timestamps.

Changing Primary IP requires a software restart.

Startup

Setting

Description

Values / Range

Autoload last scene

Automatically load the most recently opened project when Backstage starts.

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 the full scene (all assets, outputs) has finished loading.

Checkbox

System

Setting

Description

Values / Range

Allow system go to sleep

Allow the operating system to put the server into sleep mode. Disable this 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 something on screen has changed.

Checkbox

Timing

Advanced timing parameters for schedulers and subsystem sleep intervals.

Sync Timeouts

Setting

Description

Values / Range

Timecode timeout (us)

Timeout in microseconds before an external timecode signal is considered lost.

≥ 100000 us

Sleep Times

Setting

Description

Values / Range

Scheduler sleep (ns)

Sleep interval for the main media scheduler thread.

≥ 0 ns

System scheduler sleep (ns)

Sleep interval for the system scheduler.

≥ 0 ns

Scheduler sync (ns)

Sleep interval for the scheduler synchronization thread.

≥ 0 ns

ASIO ctrl sleep (ns)

Sleep interval for the ASIO control thread.

≥ 0 ns

Lazy Loading

Setting

Description

Values / Range

Lazy Load Prepare Time (ms)

How far in advance (in milliseconds) lazy-loaded assets begin loading before they are needed on the timeline.

≥ 0 ms

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 (in producer-frame units), 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. Used for Web Consoles and 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

Camera View

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

Setting

Description

Values / Range

Display mode

UI color theme or display mode.

Dropdown

UI Presentation Synchronization

Setting

Description

Values / Range

Synchronize UI render to v-sync

Synchronize the UI rendering loop to the monitor's v-sync signal, reducing screen tearing in the UI.

Checkbox

V-Sync UI Render Timing

Target percentage of the v-sync interval at which the UI frame is rendered (visible when sync is on).

0–100%

Other

Setting

Description

Values / Range

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 Assets and Sequencer panels.

Checkbox

Paths

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

Path

Description

Assets

Default directory for asset files.

File Upload

Upload destination for remote file transfers.

File transfer infos

Location for file transfer metadata.

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 based on your hardware. Start with Auto and only switch to manual values if you encounter a specific issue.

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

  • The MB/s per Core value under Image Sequence is critical for uncompressed playback performance. It 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 the Node sync NIC and PTP Clock NIC to use the same dedicated synchronization network.

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

GPU Output — bit depth, sync and color settings per output.

Performance Overview — monitor real-time performance metrics.

Log — view and filter application log messages.

Color Spaces, Color Primaries, and Transfer Functions — the color science behind the Colorspace settings.