Displays - FlowDeck

flowdeck simulator displays lists every screen a booted simulator exposes, with the screen ID that --display accepts on ui simulator screen, simulator frames, and simulator record. It reads the screen list from xcrun simctl io <udid> enumerate, the place Apple publishes a device’s screen IDs.

# 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

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

{
  "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

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.