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 verifies the physical orientation and, when available, the visible orientation.

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 when both are verified, and always false with --no-wait. On Duo, the default wait verifies physical orientation through the native motion stream, so success reflects that readback while confirmed remains false and visualOrientation is unknown. With --no-wait, Duo returns dispatch success and the requested orientation. Other modern simulators return the actual orientation acknowledged by the guest; a locked device can reject the requested rotation.
The default wait returns the verified physical orientation. The front-most app can constrain its visible orientation, which is reported separately when available.
With --no-wait, FlowDeck does not wait for visual confirmation. Unsupported values, including portrait-upside-down on ordinary iPhone simulators, are still rejected before the event is sent.
portrait-upside-down is supported on Duo and iPad simulators. Ordinary iPhone simulators reject it.