Orientation

Get or set simulator orientation

Read or change the physical orientation of an iOS simulator.

flowdeck simulator orientation

flowdeck simulator orientation defaults to get.

# Read the current orientation from the current booted simulator
flowdeck simulator orientation

# Explicit get subcommand
flowdeck simulator orientation get

# Target a specific simulator
flowdeck simulator orientation get --simulator "iPhone 16"

# JSON output
flowdeck simulator orientation get --json

# Usage examples
flowdeck simulator orientation --examples
flowdeck simulator orientation get --examples

Get Options

Option	Short	Description
--simulator <name-or-udid>	-S	Target simulator name or UDID
--json	-j	Output as JSON
--examples	-e	Show usage examples

Get JSON Output

{
  "schema": "flowdeck.simulator",
  "schemaVersion": "1.0.0",
  "success": true,
  "type": "orientation_get",
  "orientation": "landscape-left",
  "udid": "12345678-1234-1234-1234-123456789ABC"
}

If you omit --simulator, FlowDeck targets the current booted simulator. If no simulator is booted, the command fails.

---

flowdeck simulator orientation set

Set the simulator orientation and wait until the physical state matches the confirmed result.

flowdeck simulator orientation set portrait --simulator "iPhone 16"
flowdeck simulator orientation set landscape-left --simulator "iPhone 16"
flowdeck simulator orientation set landscape-right --simulator "iPhone 16"
flowdeck simulator orientation set portrait-upside-down --simulator "FlowDeck-Diag-iPad"

# JSON output
flowdeck simulator orientation set landscape-left --simulator "iPhone 16" --json

# Usage examples
flowdeck simulator orientation set portrait --examples

Set Options

Option	Short	Description
--simulator <name-or-udid>	-S	Target simulator name or UDID
--json	-j	Output as JSON
--examples	-e	Show usage examples

Supported Values

• portrait
• landscape-left
• landscape-right
• portrait-upside-down

Set JSON Output

{
  "schema": "flowdeck.simulator",
  "schemaVersion": "1.0.0",
  "success": true,
  "type": "orientation_set",
  "orientation": "landscape-left",
  "udid": "12345678-1234-1234-1234-123456789ABC"
}

FlowDeck returns the confirmed orientation, not just the requested value. If the front-most app does not support the requested orientation, the result reflects what the simulator actually applied.

portrait-upside-down is not supported on iPhone simulators. Use an iPad simulator if you need to validate upside-down orientation behavior.