# Creating Recordings

> Record high-quality GIF and MP4 videos from the iOS Simulator and connected physical devices with touch indicators, device bezels, audio, and custom backgrounds.

RocketSim lets you create GIF and MP4 recordings from the **Captures** tab in the side window. You can record the Xcode Simulator with touches, audio, device bezels, and transparent or custom backgrounds. If you need recordings optimized for App Store Connect, see [App Store Connect Optimization](/docs/features/capturing/app-store-connect-optimization).

RocketSim 16 also supports video recordings from connected physical iOS devices, including audio from the device stream. See [Physical Device Testing](/docs/features/physical-devices/) for setup and device-specific behavior.

For final tweaks after recording, RocketSim includes a built-in [Post Editor](/docs/features/capturing/post-editor) that lets you trim and restyle the exported result.

## Creating a recording

1. Open the Simulator or connect a supported physical iOS device
2. Select the **Captures** tab inside the RocketSim Side Window
3. Click **GIF Record** or **MP4 Record** and perform your interactions

![RocketSim Side Window Captures tab with GIF Record and MP4 Record](./recordings/rocketsim_side_window_screenshot.png)

4. Press **Stop** when you're done
5. A floating thumbnail appears in the bottom right corner — drag or copy your recording from there

Most capture options (bezels, touches, audio, ratio, background) can be set before you start, either in the **Captures** tab or in **Settings → Captures**.

## Capture options

Configure how your recordings look and what they include. All of the following are available in the **Captures** tab of the side window; many are also in **Settings → Captures**.

### Device bezels

You can add a device frame around the Simulator content. Choose **None**, **Simulator Bezel** (the standard Simulator chrome), or a **real device bezel** (device-specific frames for supported iPhone and iPad models). Current coverage includes iPhone 18 Pro, iPhone 18 Pro Max, the iPad (A16), 11-inch and 13-inch iPad Pro (M5), and the folded and unfolded iPhone Duo. Use the **Device Bezel** picker in the Captures tab. Your choice is stored per device, so each Simulator type can have its own preference.

### iPhone Duo recordings

Recordings of an iPhone Duo Simulator capture both displays and the live hinge angle. RocketSim renders the fold pose through Apple's 3D folding model in the app, the Post Editor, previews, and thumbnails, so folding or unfolding the Duo while you record shows up in the final video. As with other devices, the output supports transparent or custom backgrounds, and the automatic ratio stays compact while the Duo is folded and expands as it unfolds.

### Rotating while recording

Rotating an iPhone, iPad, or iPhone Duo Simulator while you record is preserved and smoothly animated in editor previews, thumbnails, and exported videos. Landscape and upside-down captures stay upright everywhere, with touches drawn where you tapped.

### Touches and touch attention

- **Show touches in recordings** — Renders touch indicators so viewers can see taps and gestures. You can also enable **Show stroke around touches** in Settings → Captures.
- **Touch Attention Mode** — Keeps a single touch indicator on screen that follows your mouse pointer the whole time, useful for directing attention in demos.
- **Touches color** — Pick a custom color for the touch indicators in the Captures tab or in Settings → Captures (plain colors only).
- **Touch pointer size** — Make touch indicators smaller or larger using the slider in Settings → Captures.

See also [Touch indicators](/docs/features/capturing/touch-indicators) for more on how touches appear in captures.

### Device shadow

When you use device bezels, you can turn on **Device shadow** to add a shadow behind the device frame. The toggle is in the Captures tab and in Settings → Captures under Bezels.

### Audio

- **Simulator audio** — Records only the audio that comes out of the Simulator (your app's sound). It does not record system audio or other apps. Enable it with **Record audio** in the Captures tab or **Record Simulator audio during recordings** in Settings → Captures. No custom drivers are required.
- **Physical device audio** — When recording a connected physical device, RocketSim records audio from the device stream.
- **Microphone** — Optionally record from any system microphone (e.g. for voiceover). In the Captures tab, use the **Microphone** picker and choose **None** or a device. You can use Simulator audio and a microphone at the same time.

### Output ratio

You can lock the output to a specific aspect ratio. Supported values: **Auto** (no fixed ratio), **1:1**, **5:4**, **4:3**, **3:2**, and **16:9**. Set it with the **Ratio** picker in the Captures tab.

### Background and frame

- **Background** — Choose what appears behind the device: **plain colors**, **gradient (mesh) backgrounds**, or **transparent**. Use the **Background** control in the Captures tab or **Captures background** in Settings → Captures. Transparent is the default.
- **Device Frame color** — When using bezels, you can set the frame color separately (plain colors) in Settings → Captures under Bezels.

## Audio recording

Enable **Record audio** (Simulator audio) or pick a **Microphone** (or both) in the Captures tab or in **Settings → Captures**. RocketSim does not install custom audio drivers; it works with the system as-is. For details on what each option records, see [Capture options > Audio](#audio) above.

## Editing and trimming a recording

Once your recording is done, open it from the [floating thumbnail](/docs/features/capturing/floating-thumbnail) to continue in the [Post Editor](/docs/features/capturing/post-editor). There you can trim the beginning and end of the recording, preview playback, and refine the final styling before converting the result.

Enable **Open editor directly after recording** under **RocketSim → Settings → Captures → Editing** when you always want to trim before exporting. RocketSim opens the editor as soon as recording stops and skips the initial conversion, so you avoid converting frames you are about to trim away. Closing the editor without exporting starts the normal conversion for the original recording.

![Recording post editor showing the trim timeline, preview, and export controls.](./post-editor/video-post-editor.png)

## Transparent recordings

You can create recordings with a transparent background. Set the background to transparent in the **Background** picker (see [Capture options > Background and frame](#background-and-frame)) in the Captures tab or in **Settings → Captures**:

![Transparent background setting in Captures](./recordings/transparent_background_setting.png)

App Store Connect videos cannot have alpha layers, so disable **App Preview Optimized** mode if you need transparency. Apps like QuickTime may not show transparency correctly — copy your video into Keynote to verify:

![Transparent background verified in Keynote](./screenshots/cleanshot_2023-11-01_at_13.45.082x.png)

## Capture Metadata

Recordings can show the app icon, app title, and an optional subtitle on the background. That helps viewers see which app they're watching in demos and App Store previews.

RocketSim takes this metadata from your most recent build: it reads the app icon and display name from the running Simulator app, so you don't have to configure anything for the basics.

![Recording background with app icon, title, and subtitle](./recordings/metadata-example.png)

### Using a custom metadata title or subtitle

To override the app name or add a custom subtitle (e.g. a version or tagline), configure them in the App Group settings for that app. RocketSim will use those values on the recording background instead of the default app name. You can also fine-tune the metadata contents later in the [Post Editor](/docs/features/capturing/post-editor).

![App Group settings for custom app name and subtitle](./recordings/metadata-settings.png)

For more on creating and managing App Groups, see [Configuring App Actions](/docs/getting-started/configuring-app-actions).

## Troubleshooting

### I enabled audio, but it's not working?

Make sure you don't have any audio routing enabled. Doing so can prevent RocketSim from recording Simulator audio or your microphone correctly.

### Does RocketSim install a custom audio driver for audio recording?

No, there's nothing you need to install for audio recording to work.
