> For the complete documentation index, see [llms.txt](https://tractus.gitbook.io/tractus-tools-for-ndi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tractus.gitbook.io/tractus-tools-for-ndi/getting-started/ndi-tally.md).

# NDI Tally

Multiview for NDI supports displaying NDI tally status (preview/program) on each viewport. Tally can be reported via a border color change, a tally PNG flag, or both.

Each viewport can have it's own settings (breakaway), or you can apply the same settings to every viewport.

{% hint style="info" %}
NDI Tally state is available in 2025.6.18.1 and onward.
{% endhint %}

### Tally Flag Defaults

{% hint style="warning" %}
Before setting up your tally flag defaults, you should set up your viewports. These defaults will only apply to the viewports that exist when **Apply to All Viewports** is clicked.
{% endhint %}

In **Edit Layout**, there is a section called Tally Flag Defaults. This allows you to set the default tally flag PNG for all viewers.

<figure><img src="https://4106520823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu8sK5xu39P2AP0P0y4Nm%2Fuploads%2Fgit-blob-048f56146b564dfcd9c296de26158ec167fe7771%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

By default, Multiview for NDI ships with the following tally flag PNGs.

<table><thead><tr><th width="247">Name</th><th>Image</th></tr></thead><tbody><tr><td><pre><code>pvw.png
</code></pre></td><td><img src="https://4106520823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu8sK5xu39P2AP0P0y4Nm%2Fuploads%2Fgit-blob-35e2d8189c5ee1320c96e4280bb6ba36fe668e21%2Fpvw.png?alt=media" alt=""></td></tr><tr><td><pre><code>pgm.png
</code></pre></td><td><img src="https://4106520823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu8sK5xu39P2AP0P0y4Nm%2Fuploads%2Fgit-blob-7ac18edd1d1803ab98bb39769e5f7532b59d31dd%2Fpgm.png?alt=media" alt=""></td></tr><tr><td><pre><code>pvw_triangle.png
</code></pre></td><td><img src="https://4106520823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu8sK5xu39P2AP0P0y4Nm%2Fuploads%2Fgit-blob-c767a3ac895b21b848e5f21a6c01c7224976f284%2Fpvw_triangle.png?alt=media" alt=""></td></tr><tr><td><pre><code>pgm_triangle.png
</code></pre></td><td><img src="https://4106520823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu8sK5xu39P2AP0P0y4Nm%2Fuploads%2Fgit-blob-6167c76f49a620660636242d10669340dd227656%2Fpgm_triangle.png?alt=media" alt=""></td></tr></tbody></table>

In our example, we will set the **Preview Flag** to be `pvw.png` and the **Program Flag** to be `pgm.png`.

<figure><img src="https://4106520823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu8sK5xu39P2AP0P0y4Nm%2Fuploads%2Fgit-blob-d5882eaf4b1335d36f3daa305722e6ce3a499827%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Next, we will set the location of those flags, along with border changes.

### Flag Location & Border Changes

<figure><img src="https://4106520823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu8sK5xu39P2AP0P0y4Nm%2Fuploads%2Fgit-blob-f8bd810832c495f009910ede197b1317d687be7c%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Tally flags can be positioned at the top-left, top-center, top-right, bottom-left, bottom-center, and bottom-right of a viewport.

If **None** is selected, that tally flag will never be displayed.

{% hint style="info" %}
An NDI source can be in preview and program simultaneously. In that case, both flags will display if configured to display.
{% endhint %}

For the **Border** option, you can choose to have Multiview for NDI highlight the viewport with a **Green** border for preview, and **Red** for Program.

{% hint style="info" %}
If a source is in both preview and program, the **program border highlight** will take precedence.
{% endhint %}

For this example, we will set the Preview Flag to display at the Bottom-Center, and the Program Flag to display at the Top-Center, and apply a border highlight when the viewport's source is in preview/program.

<figure><img src="https://4106520823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu8sK5xu39P2AP0P0y4Nm%2Fuploads%2Fgit-blob-9129c354406288d4714f22b6a8c5db685b08c9bb%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Click on **Apply to All Viewports** to apply the changes to this layout.

{% hint style="warning" %}
You will need to click **Save Changes** below to see these tally flag changes appear.
{% endhint %}

### Applying Tally Flags & Borders Per Viewport (Breakaway)

After selecting a viewport in Edit Layout mode, you can set the location of each tally flag, along with border highlight.

<figure><img src="https://4106520823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu8sK5xu39P2AP0P0y4Nm%2Fuploads%2Fgit-blob-687ee73da9d095daeb013aa87ab6eb568e592840%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Once finished, click **De-Select**, then **Save Changes** to see your tally state changes.

With some NDI sources added to your multiview, you should see tally similar to the following.

<figure><img src="https://4106520823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu8sK5xu39P2AP0P0y4Nm%2Fuploads%2Fgit-blob-3ebaf92086ca510f0b909179064c75059350d9d2%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
