Skip to main content
Version: 1.47.0

Settings View

caution

The settings views are only visible to users with the correct access level!

Recommended read before diving into the settings: System, (Organization), Studio & Show Style.

System

The System settings are settings for this installation of Sofie. In here goes the settings that are applicable system-wide.

caution

Documentation for this section is yet to be written.

Studio

A Studio in Sofie-terms is a physical location, with a specific set of devices and equipment. Only one show can be on air in a studio at the same time.
The studio settings are settings for that specific studio, and contains settings related to hardware and playout, such as:

  • Attached devices - the Gateways related to this studio
  • Blueprint configuration - custom config option defined by the blueprints
  • Layer Mappings - Maps the logical timeline layers to physical devices and outputs

The Studio uses a studio-blueprint, which handles things like mapping up an incoming rundown to a Showstyle.

Attached Devices

This section allows you to add and remove Gateways that are related to this Studio. When a Gateway is attached to a Studio, it will react to the changes happening within it, as well as feed the neccessary data into it.

Blueprint Configuration

Sofie allows the Blueprints to expose custom configuration fields that allow the System Administrator to reconfigure how these Blueprints work through the Sofie UI. Here you can change the configuration of the Studio Blueprint.

Layer Mappings

This section allows you to add, remove and configure how logical device-control will be translated to physical automation control. Blueprints control devices through objects placed on a Timeline using logical device identifiers called Layers. A layer represents a single aspect of a device that can be controlled at a given time: a video switcher's M/E bus, an audio mixers's fader, an OSC control node, a video server's output channel. Layer Mappings translate these logical identifiers into physical device aspects, for example:

A sample configuration of a Layer Mapping for the M/E1 Bus of an ATEM switcher

This Layer Mapping configures the atem_me_program Timeline-layer to control the atem0 device of the ATEM type. No Lookahead will be enabled for this layer. This layer will control a MixEffect aspect with the Index of 0 (so M/E 1 Bus).

These mappings allow the System Administrator to reconfigure what devices the Blueprints will control, without the need of changing the Blueprint code.

Route Sets

In order to allow the Producer to reconfigure the automation from the Switchboard in the Rundown View, as well as have some pre-set automation control available for the System Administrator, Sofie has a concept of Route Sets. Route Sets work on top of the Layer Mappings, by configuring sets of Layer Mappings that will re-route the control from one device to another, or to disable the automation altogether. These Route Sets are presented to the Producer in the Switchboard panel.

A Route Set is essentially a distinct set of Layer Mappings, which can modify the settings already configured by the Layer Mappings, but can be turned On and Off. Called Routes, these can change:

  • the Layer ID to a new Layer ID
  • change the Device being controlled by the Layer
  • change the aspect of the Device that's being controlled.

Route Sets can be grouped into Exclusivity Groups, in which only a single Route Set can be enabled at a time. When activating a Route Set within an Exclusivity Group, all other Route Sets in that group will be deactivated. This in turn, allows the System Administrator to create entire sections of exclusive automation control within the Studio that the Producer can then switch between. One such example could be switching between Primary and Backup playout servers, or switching between Primary and Backup talent microphone.

The Exclusivity Group Name will be displayed as a header in the Switchboard panel

A Route Set has a Behavior property which will dictate what happens how the Route Set operates:

TypeBehavior
ACTIVATE_ONLYThis RouteSet cannot be deactivated, only a different RouteSet in the same Exclusivity Group can cause it to deactivate
TOGGLEThe RouteSet can be activated and deactivated. As a result, it's possible for the Exclusivity Group to have no Route Set active
HIDDENThe RouteSet can be activated and deactivated, but it will not be presented to the user in the Switchboard panel

An active RouteSet with a single Layer Mapping being re-configured

Route Sets can also be configured with a Default State. This can be used to contrast a normal, day-to-day configuration with an exceptional one (like using a backup device) in the Switchboard panel.

Default StateBehavior
ActiveIf the Route Set is not active, an indicator will be shown
Not ActiveIf the Route Set is active, an indicator will be shown
Not definedNo indicator will be shown, regardless of the Route Set state

Show style

A Showstyle is related to the looks and logic of a show, which in contrast to the studio is not directly related to the hardware.
The Showstyle contains settings like

  • Source Layers - Groups different types of content in the GUI
  • Output Channels - Indicates different output targets (such as the Program or back-screen in the studio)
  • Action Triggers - Select how actions can be started on a per-show basis, outside of the on-screen controls
  • Blueprint configuration - custom config option defined by the blueprints
caution

Please note the difference between Source Layers and timeline-layers:

Pieces are put onto Source layers, to group different types of content (such as a VT or Camera), they are therefore intended only as something to indicate to the user what is going to be played, not what is actually going to happen on the technical level.

Timeline-objects (inside of the Pieces) are put onto timeline-layers, which are (through the Mappings in the studio) mapped to physical devices and outputs.
The exact timeline-layer is never exposed to the user, but instead used on the technical level to control playout.

An example of the difference could be when playing a VT (that's a Source Layer), which could involve all of the timeline-layers video_player0, audio_fader_video, audio_fader_host and mixer_pgm.

Action Triggers

This is a way to set up how - outside of the Point-and-Click Graphical User Interface - actions can be performed in the User Interface. Commonly, these are the hotkey combinations that can be used to either trigger AdLib content or other actions in the larger system. This is done by creating sets of Triggers and Actions to be triggered by them. These pairs can be set at the Show Style level or at the Sofie Core (System) level, for common actions such as doing a Take or activating a Rundown, where you want a shared method of operation. Sofie Core migrations will set up a base set of basic, system-wide Action Triggers for interacting with rundowns, but they can be changed by the System blueprint.

Action triggers define modes of interacting with a Rundown

Triggers

The triggers are designed to be either client-specific or issued by a peripheral device module.

Currently, the Action Triggers system only supports a single, client-specific trigger type: a Hotkey. Hotkeys can be either a single key, a combination of keys (combo) or a chord - a sequnece of key combinations pressed in a particular order. Chords are popular in some text editing applications and vastly expand the amount of actions that can be triggered from a keyboard, at the expense of the time needed to execute them. Currently, the Hotkey editor in Sofie does not support creating Chords, but they can be specified by Blueprints during migrations.

To edit a given trigger, click on the trigger pill on the left of the Trigger-Action set. When hovering, a + sign will appear, allowing you to add a new trigger to the set.

Actions

The actions are built using a base action (such as Activate a Rundown or AdLib) and a set of filters, limiting the scope of the action. Optionally, some of these actions can take additional parameters. These filters can operate on various types of objects, depending on the action in question. All actions currently require that the chain of filters starts with scoping out the Rundown the action is supposed to affect. Currently, there is only one type of Rundown-level filter supported: "The Rundown currently in view".

The Action Triggers user interface guides the user in a wizzard-like fashion through the available filter options on a given action.

Actions can take additional parameters

If the action provides a preview of the triggered items and there is an available matching Rundown, a preview will be displayed for the matching objects in that Rundown. The system will select the current active rundown, if it is of the currently-edited ShowStyle, and if not, it will select the first available Rundown of the currently-edited ShowStyle.

A preview of the action, as scoped by the filters

Clicking on the action and filter pills allows you to edit the action parameters and filter parameters. Limit limits the amount of objects to only the first N objects matched - this can significantly improve performance on large data sets. Pick and Pick last filters end the chain of the filters by selecting a single item from the filtered set of objects (the N-th object from the beginning or the end, respectively). Pick implicitly contains a Limit for the performance improvement. This is not true for Pick last, though.

Migrations

The migrations are automatic setup-scripts that help you during initial setup and system upgrades.

There are system-migrations that comes directly from the version of Sofie Core you're running, and there are also migrations added by the different blueprints.

It is mandatory to run migrations when you've upgraded Sofie Core to a new version, or upgraded your blueprints.