LiveWing
App

Presets and Project Settings

Project resolution and frame rate, what presets contain, auto-save, and backward compatibility.

A LiveWing preset is a complete snapshot of your production setup, stored as a JSON file in Application Support. Load a preset to restore a show configuration instantly — sources, audio, outputs, replay settings, and UI state all come back exactly as you left them.

Project format

Every preset specifies a project resolution and project frame rate. All program outputs conform to these values regardless of what resolution or frame rate the individual sources deliver.

Resolution

OptionDimensions
1080p (default)1920×1080
4K3840×2160

Frame rate

RateNotes
23.976 fpsDrop-frame film timescale (60000/1001)
24 fps
25 fpsPAL
29.97 fpsNTSC drop-frame (30000/1001)
30 fps
50 fpsPAL sports
59.94 fpsNTSC sports, default (60000/1001)
60 fps

The default is 59.94 fps / 1080p. NTSC drop-frame rates (23.976, 29.97, 59.94) use the correct broadcast timescales to prevent rounding drift on long-running streams.

Per-output resolution override

Individual output channels and recorders can override the project resolution without changing the project format:

  • Project — use the project resolution (default)
  • 1080p — 1920×1080 (only available as a downscale from 4K; not available if project is already 1080p)
  • 720p — 1280×720

LiveWing never upscales. If an override exceeds the project resolution, the project resolution is used instead.

What a preset contains

Presets are versioned JSON files (current schema version: 2). Every field has a default, and old presets missing new fields load and repair cleanly. The preset stores:

  • Angles — each input slot's label, device ID, source kind, audio config, source transform, input overlays, and loop state
  • Switcher state — which angle is on program and which is on preview
  • Audio — per-source mute state; master audio config (gain, limiter ceiling, limiter bypass)
  • Output channels — up to 4 channels with active destinations, RTMP/SRT/record config, audio bus assignment, and resolution override
  • Recorders — up to 4 independent recorder slots with source, codec, bitrate, format, directory, and audio bus
  • Replay — up to 4 replay angle slot assignments, predefined event labels, and storage config (codec, segment duration, disk budget, directory)
  • Fullscreen outputs — external display assignments by screen name
  • Multi-view — layout preset and overlay configuration
  • Project format — resolution and frame rate
  • UI state — PVW/PGM split fraction (0.10–0.90), tile display order, collapsed tiles

Auto-save

The "Default" preset auto-saves on every change. The app always restores to exactly the state it was in when it last ran. There is no need to explicitly save before quitting.

Named presets

Named presets are created from the current state. They capture the same full snapshot as the Default preset but are not auto-updated. Load a named preset to switch completely to a saved configuration.

Named presets are stored alongside the Default preset in Application Support. They are plain JSON and can be inspected, diffed, and version-controlled.

Backward compatibility

When loading a preset from an older schema version, LiveWing repairs unknown or missing fields to safe defaults and logs each repair. If the program or preview source ID references an angle that no longer exists, it is remapped to the first valid angle. Invalid channel IDs, negative segment durations, unknown codecs, and out-of-range split fractions are all repaired automatically.

The WebSocket API exposes preset.getProjectFormat and preset.setProjectFormat to read and change the project format from an external automation system.

On this page