Use simulator hardware commands for device-level controls that are not tied to a specific app UI.
Press a simulator hardware button.
flowdeck simulator button home
flowdeck simulator button lock --hold 2.0
flowdeck simulator button siri --simulator "iPhone 16"
flowdeck simulator button home --json
| Option | Short | Description |
|---|
--simulator <name-or-udid> | -S | Target simulator name or UDID |
--hold <seconds> | | Hold the button for a duration |
--json | -j | Output as JSON |
--examples | -e | Show usage examples |
homelocksiriapplepayvolumeupvolumedown
Volume buttons may not be supported by the simulator HID backend on every runtime.
flowdeck simulator appearance
Get or set the simulator appearance (light or dark). Mirrors flowdeck simulator orientation: get is the default subcommand, set writes a value.
flowdeck simulator appearance # Print booted simulator appearance
flowdeck simulator appearance get # Same as above
flowdeck simulator appearance set light
flowdeck simulator appearance set dark --simulator "iPhone 16"
flowdeck simulator appearance set dark --json
flowdeck simulator appearance get --json
flowdeck simulator appearance get
Print the current appearance for the targeted simulator. Outputs one of light, dark, unsupported, or unknown (passed through from simctl ui ... appearance).
| Option | Short | Description |
|---|
--simulator <name-or-udid> | -S | Target simulator name or UDID |
--json | -j | Output as JSON |
--examples | -e | Show usage examples |
flowdeck simulator appearance set
Set the appearance to light or dark.
| 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
Older flowdeck ui simulator button, flowdeck ui simulator set-appearance (also accepts appearance as an alias), and flowdeck ui simulator orientation commands still work for compatibility, but new scripts should use flowdeck simulator ....
