iOS Simulator Recording: The Complete Guide

Why Record the iOS Simulator?

If you're an iOS developer, you need to record the Simulator constantly. App Store preview videos, social media demos, bug reports, PR reviews, documentation — the use cases are endless.

But recording the Simulator well is surprisingly tricky. The built-in options have limitations (no cursor, no audio, wrong resolution), and most screen recording tools don't understand what the Simulator is or how to capture it properly.

This guide covers every method available in 2026, from free command-line tools to dedicated apps, so you can pick the right one for your workflow.

Method 1: xcrun simctl (Command Line)

The most basic approach. Apple's simctl command-line tool can record the Simulator directly:

# Start recording
xcrun simctl io booted recordVideo output.mp4

# Press Ctrl+C to stop

# Record a specific device (by UDID)
xcrun simctl io 8A5B3C7D-... recordVideo demo.mp4

Options

• --codec h264 — Use H.264 encoding (default)
• --codec hevc — Use HEVC/H.265 for smaller files
• --mask black — Add black mask around device shape
• --mask alpha — Transparent background (for compositing)
• --force — Overwrite existing file

# Record with HEVC and device mask
xcrun simctl io booted recordVideo --codec hevc --mask black demo.mp4

Limitations

• No cursor capture. The mouse cursor is not included in simctl recordings. This is a dealbreaker for demo videos where you need to show taps and interactions.
• No audio. simctl only captures video — no app audio, no microphone.
• No editing. You get a raw video file. Trimming, adding text, or adjusting speed requires a separate tool.
• Resolution tied to Simulator window size. Whatever size the Simulator window is, that's what you get.

Method 2: Xcode's Built-in Recorder

Since Xcode 12.5, the Simulator app has a built-in screen recorder:

1. Open the Simulator
2. Go to File → Record Screen (or press ⌘R)
3. A recording indicator appears in the toolbar
4. Click the stop button or press ⌘R again to stop
5. The recording saves to your Desktop

This is essentially a GUI wrapper around simctl recordVideo. It's slightly more convenient but has all the same limitations — no cursor, no audio, no editing.

Export Formats

The Simulator recorder exports as MP4 by default. You can also export as GIF by holding the Option key when clicking the stop button — useful for quick demos in documentation or README files.

Method 3: macOS Screen Recording (⌘⇧5)

You can use macOS's built-in screen recording to capture the Simulator window:

1. Press ⌘⇧5 to open the Screenshot toolbar
2. Select "Record Selected Portion" or "Record Entire Screen"
3. Draw a selection around the Simulator window
4. Click Record

Advantages Over simctl

• Captures the cursor. Your mouse movements and clicks are visible in the recording.
• Can capture system audio (with the right settings in macOS Sequoia+)
• Familiar workflow. No terminal needed.

Limitations

• Captures the window chrome. You get the Simulator's title bar, bezels, and whatever is behind the window. Not a clean device recording.
• Resolution depends on screen. If you're on a 1080p display, your recording is 1080p — regardless of the simulated device's native resolution.
• No device frames. You're recording a window, not creating a framed device video.
• No editing. Raw video file, same as the others.

Method 4: QuickTime Player

QuickTime can record the screen and also record directly from a connected iOS device via USB. For Simulator recording specifically:

1. Open QuickTime Player
2. File → New Screen Recording
3. Select the area around the Simulator
4. Record

This is functionally identical to ⌘⇧5 on modern macOS. The only advantage is that QuickTime offers basic trimming — you can cut the start and end of your recording before saving.

Method 5: Matte (Recommended)

Recording the Simulator with Matte

1. Open Matte and select "Simulator Recording"
2. Choose your target Simulator device from the dropdown
3. Click Record — Matte captures the Simulator output directly
4. Interact with your app normally (taps and cursor are captured)
5. Stop recording and edit in the timeline
6. Choose a device frame (iPhone 15 Pro, iPad Air, etc.)
7. Export as App Store preview, social media post, or custom resolution

The entire workflow — from recording to final export — takes minutes, not hours.

Comparison: All Methods Side by Side

Tips for Better Simulator Recordings

Regardless of which method you use, these tips will improve your recordings:

1. Set the Right Simulator Size

Before recording, make sure your Simulator is running at the correct point size. In the Simulator menu, go to Window → Physical Size (or ⌘1) to match the real device dimensions. This ensures your recording has the correct aspect ratio for App Store previews.

2. Clean Up the Status Bar

Use simctl status_bar to set a clean, consistent status bar:

# Set a clean status bar
xcrun simctl status_bar booted override \
  --time "9:41" \
  --batteryState charged \
  --batteryLevel 100 \
  --wifiBars 3 \
  --cellularBars 4 \
  --operatorName ""

# Reset to default
xcrun simctl status_bar booted clear

9:41 is the traditional time Apple uses in marketing materials. Charged battery and full signal bars look professional.

3. Pre-load Your Data

Don't record yourself typing test data. Before you hit record, make sure your app has realistic sample data loaded. Use #if DEBUG blocks or launch arguments to load demo content automatically.

4. Script Your Interactions

Plan your tap sequence before recording. Know exactly what screens you'll show and in what order. App Store preview videos are 15-30 seconds — every second counts. Write a shot list:

1. App opens → main screen (2 seconds)
2. Tap into feature X (3 seconds)
3. Demonstrate the core value (5 seconds)
4. Show result/output (3 seconds)

5. Slow Down Your Interactions

Move the cursor deliberately. Pause briefly after each tap so viewers can follow. Real-time usage feels frantic in a recording — slow it down by about 30% from your natural speed.

6. Use Slow Animations for Drama

Enable slow animations in the Simulator (Debug → Slow Animations or ⌘T) for specific transitions you want to highlight. Just remember to turn it off for normal navigation.

Recording for App Store Preview Videos

App Store preview videos have specific requirements:

• Duration: 15-30 seconds
• Format: H.264, MP4
• Frame rate: 30 fps
• Resolution: Must match the device display (e.g., 1290×2796 for iPhone 15 Pro)
• Content: Must show actual in-app footage (not just mockups)

The resolution requirement is the tricky part with free tools. simctl captures at whatever resolution the Simulator window is rendering at, which may not match the App Store requirement exactly. You'll need to resize in post-production.

Matte handles this automatically — its App Store presets export at the exact resolution for each device class, no manual resizing needed.

Recording for Social Media

Different platforms want different things:

• Twitter/X: 1:1 or 16:9, max 2:20, under 512MB. Device frames with colorful backgrounds work great.
• Instagram Reels: 9:16 vertical, 15-90 seconds. Full-screen device recording in a phone frame.
• YouTube: 16:9, any length. Device frame centered on a gradient background.
• Reddit/HN: Direct MP4 links or GIFs. Keep it short (under 30 seconds).

For social media, you almost always want a device frame around your recording. A floating app UI without context looks weird — wrap it in an iPhone frame and it immediately reads as "app demo."

The Bottom Line

For quick development captures — bug reports, PR reviews, Slack messages — xcrun simctl recordVideo or ⌘⇧5 are fine. They're free, fast, and already on your Mac.

For anything public-facing — App Store previews, social media demos, landing page videos, product launches — you need device frames, proper resolution, and at minimum basic editing. That's where Matte saves you hours of post-production in After Effects or Premiere.