Yang Sun App Studio
Back to Blog
2026-11-176 min readTechnology

How to Screenshot the iPhone Duo Inner Display from the CLI (2853x2007)

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:

  1. Launch sequence: close -> launch -> open. On an already-unfolded Duo, launching can leave the app in portrait.
  2. Orientation mask: add LandscapeLeft/Right to the iPhone orientations (iPad-only does not apply), then drive the mask from horizontalSizeClass in supportedInterfaceOrientationsFor.

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?

ToolPricePose CLILocale matrixLint
hingeFree (MIT)yesnono
RocketSimFree CLI; Pro $69.99/yryesnono
duokit$19 one-timeyesyesyes

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.

duokit

#iPhone Duo#simctl#Xcode#hinge#duokit#screenshot#foldable