Short answer: use xcrun simctl io <udid> screenshot --display 3 out.png. The flag is mandatory — a plain screenshot fails with Invalid argument on a foldable, and a folded Duo returns a black inner frame. There is no simctl/devicectl fold command; for scriptable pose control use hinge (free, MIT).
Why "Invalid argument"?
The Duo has two integrated displays and simctl cannot guess:
xcrun simctl io booted screenshot --display 1 cover.png # 1398x2034
xcrun simctl io booted screenshot --display 3 inner.png # 2853x2007 landscape
The inner display is 951x669pt @3x = 2853x2007px, the size App Store Connect expects in the APP_IPHONE_DUO slot.
Why is my screenshot black?
The device is folded — the inner display is off. Unfold first, then wait: the active display switches 1-2.5s after the angle changes.
brew install artemnovichkov/tap/hinge
hinge open
sleep 2.5
xcrun simctl io booted screenshot --display 3 inner.png
hinge reads the angle back from CoreMotion, so an ignored fold is an error, not a silent success. hinge posture tells you which display hosts the UI.
Landscape stuck in portrait?
A portrait-only app will not auto-rotate on the inner display (field-verified). Two fixes:
- Launch sequence: close -> launch -> open. On an already-unfolded Duo, launching can leave the app in portrait.
- Orientation mask: add LandscapeLeft/Right to the iPhone orientations (iPad-only does not apply), then drive the mask from
horizontalSizeClassinsupportedInterfaceOrientationsFor.
Layout traps: the inner top safe area is ~84pt and there is a ~81pt trailing reserved strip; hardcoded top insets slide content under the status bar.
Which tool?
| Tool | Price | Pose CLI | Locale matrix | Lint |
|---|---|---|---|---|
| hinge | Free (MIT) | yes | no | no |
| RocketSim | Free CLI; Pro $69.99/yr | yes | no | no |
| duokit | $19 one-time | yes | yes | yes |
For a one-off shot, hinge + simctl is all you need. For a full ASC asset set across locales, or driving the Duo from Claude Code/Cursor via MCP, see duokit.