> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowdeck.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Displays

> List the screens a booted simulator exposes and their IDs for --display

`flowdeck simulator displays` lists every screen a booted simulator exposes, with the screen ID that `--display` accepts on [`ui simulator screen`](https://docs.flowdeck.studio/cli/commands/ui/automation), [`simulator frames`](https://docs.flowdeck.studio/cli/commands/simulator/frames), and [`simulator record`](https://docs.flowdeck.studio/cli/commands/simulator/record).

It reads the screen list from `xcrun simctl io <udid> enumerate`, the place Apple publishes a device's screen IDs.

```bash theme={null}
# The booted simulator
flowdeck simulator displays

# A specific simulator, as JSON
flowdeck simulator displays -S "iPhone Duo" --json

# Show usage examples
flowdeck simulator displays --examples
```

## Output

```text theme={null}
Displays for iPhone Duo (308E4600-47F6-4B61-8746-08FD0AADA902)

ID  NAME       TYPE        SIZE       ORIENTATION     PANEL
1   LCD        Integrated  1398x2034  Landscape Left  cover
2   TVOut      TVOut       720x480    Ambiguous       -
3   LCD-1      Integrated  2007x2853  Landscape Left  inner
4   Wireless   CarPlay     720x480    Ambiguous       -
5   Resizable  Scene       7680x4320  Ambiguous       -

Capture one with --display <ID> on `ui simulator screen`, `simulator frames`, or `simulator record`.
```

| Column | Meaning |
| - | - |
| `ID` | The value to pass to `--display` |
| `NAME` | The screen name simctl reports |
| `TYPE` | `Integrated` (the device's own panel), `TVOut`, `CarPlay`, `Scene`, or the raw type a newer Xcode reports |
| `SIZE` | Pixel size in the device's native buffer orientation |
| `ORIENTATION` | The screen's current UI orientation |
| `PANEL` | `cover` or `inner` for the two integrated screens of an iPhone Duo; `-` otherwise |

A regular iPhone lists its own screen as ID 1 plus the same non-iPhone screens (TV out, CarPlay, scene).

## JSON

```json theme={null}
{
  "success": true,
  "type": "simulator_displays",
  "udid": "308E4600-47F6-4B61-8746-08FD0AADA902",
  "displays": [
    {
      "id": 1,
      "name": "LCD",
      "deviceName": "primary",
      "screenType": "Integrated",
      "integrated": true,
      "pixelWidth": 1398,
      "pixelHeight": 2034,
      "uiOrientation": "Landscape Left",
      "preferredUIScale": 3,
      "duoPanel": "cover"
    }
  ]
}
```

Fields simctl does not report are omitted. On failure the result is `{"success": false, "type": "simulator_displays", "udid": "...", "error": "..."}` and the command exits non-zero.

## Options

| Option | Short | Description |
| - | - | - |
| `--simulator <sim>` | `-S` | Simulator name or UDID (defaults to the booted simulator) |
| `--json` | `-j` | Output as JSON |
| `--examples` | `-e` | Show usage examples |

> [!NOTE]
>
> The simulator must be booted. On an iPhone Duo, capture the panel that is showing: `1` is the cover (closed) and `3` is the inner display (open). A powered-off panel captures a black image, and the TV out, CarPlay, and scene screens are not iPhone panels.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.