simctl needed.
Open Simulators & Runtimes
Go to Tools → Simulators & Runtimes (or press ⌘⇧S). This opens a separate window where you can browse, create, and manage simulators.Simulators
Browse simulators
The Simulators & Runtimes window lists all installed simulators grouped by platform (iOS, watchOS, tvOS, visionOS).Boot and shutdown
Click the power button next to any simulator to boot or shut it down. A running simulator shows a green indicator.Create a simulator
- Click + at the bottom of the Simulators list
- Choose a device type (e.g. iPhone 16 Pro)
- Choose an OS runtime
- Give it a name and click Create
Rename a simulator
Give an existing simulator a new display name without creating another device.- Open Tools → Simulators & Runtimes (⌘⇧S).
- Click the pencil icon in that simulator’s action pill (between Clone and Copy ID).
- Type the new name in the sheet. The field starts with the current name; Rename Simulator stays disabled until the name is non-empty and different.
- Click Rename Simulator.
flowdeck simulator list changes.
From the command line, the same action is:
Delete a simulator
Right-click any simulator and choose Delete. You can also delete all unavailable simulators at once via the context menu on the list header.Simulator runtimes
The Simulators & Runtimes window shows which runtimes are installed. Download additional runtimes directly from this window, or via Xcode → Platforms.Devices
Physical Apple devices appear in the Simulators & Runtimes window when connected via USB or paired wirelessly.Connect a device
- Connect the device via USB
- Trust the Mac if prompted on the device
- The device appears within a few seconds
Wireless pairing
Pair once over USB, then enable wireless pairing in Xcode’s Device Manager. After pairing, the device appears in FlowDeck over Wi-Fi.Running on simulators and devices
Select any simulator or device from the destination picker in the toolbar. The next Run targets that destination.Phone ↔ Watch companion preview
When you run an iOS app that embeds a Watch companion (Host.app/Watch/*.app), the inline simulator panel’s device-name title becomes a toggle. The phone launches as usual; the watch is not started until you tap the title to switch to watch. FlowDeck pairs/boots/installs/launches the watch as needed, then shows the watch stream with the same controls and pop-out as the phone. Tap the title again to return to the phone — the watch simulator stays running. Projects without an embedded Watch app keep a plain (non-toggle) device name.