Skip to main content
Read or change the physical orientation of an iOS simulator.

​
flowdeck simulator orientation

flowdeck simulator orientation defaults to get.

​
Get Options

​
Get JSON Output

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. By default, FlowDeck waits until the physical and visual state match the confirmed result.

​
Set Options

​
Supported Values

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

​
Set JSON Output

confirmed reports whether the orientation was actually verified against the simulator’s physical and visual state. It is true after a successful wait, and always false with --no-wait since no verification happens on that path. success stays true on --no-wait because the rotation event was dispatched without error — check confirmed to know whether that was proven.
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.
With --no-wait, FlowDeck assumes the rotation event was accepted and returns the requested orientation immediately, with confirmed: false. Unsupported values, including portrait-upside-down on iPhone simulators, are still rejected before the event is sent.
portrait-upside-down is not supported on iPhone simulators. Use an iPad simulator if you need to validate upside-down orientation behavior.