# Output Setup

Outputs represent the physical or virtual display surfaces that Exaplay 3 renders to. Each output is mapped to one Windows display.

## Adding an Output

1. Open **Config → Outputs**.
2. Click **+ Output**.
3. Choose the target display from the **Display** drop-down (lists all displays detected by Windows).
4. Set the **Resolution** and **Refresh Rate** (auto-detected from the display EDID by default).
5. Click **Save**.

![Output configuration panel](/files/59whm3zHXrq4DKjTaEZ0)

## Output Properties

| Property         | Description                                                   |
| ---------------- | ------------------------------------------------------------- |
| **Name**         | Display name used in screen tabs and the Inspector            |
| **Display**      | Windows display number (matches Windows Display Settings)     |
| **Resolution**   | Width × Height in pixels                                      |
| **Refresh rate** | Target frames per second                                      |
| **Position**     | X, Y offset within the Windows desktop (for bezel correction) |
| **Warp file**    | Path to a VIOSO `.vwf` calibration file                       |
| **NDI Output**   | Enable to broadcast this output as an NDI stream              |

## Multi-Screen Layout

Use the **Layout Editor** (drag-and-drop grid in the Outputs panel) to visualise and arrange the physical placement of screens relative to each other.

## Warp & Blend

Assign a VIOSO calibration file to an output to enable geometric warping and edge blending. See [Projection Mapping](/v3/features/projection-mapping.md) for full details.

## Test Pattern

Click **Show Test Pattern** next to any output to display a test card (colour bars + corner marks) while configuring outputs. This does not affect the composition — it is a temporary overlay.

## Output-List File

For headless deployments, the display configuration can also be edited directly in `output/output-list.json`. The file format is:

```json
[
  {
    "id": 0,
    "name": "Left Projector",
    "display": 1,
    "width": 1920,
    "height": 1080,
    "refreshRate": 60,
    "x": 0,
    "y": 0
  }
]
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.exaplay.one/v3/configuration/outputs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.