SpatialConverter

Overview

What this app does

SpatialConverter converts spatial videos and spatial photos recorded with iPhone or Apple Vision Pro into SBS (Side-by-Side) 3D content for playback on 3DTVs and VR headsets — and vice versa.

You can process an entire folder at once, even when video and photo files are mixed together.

🎥

Spatial Video → SBS

Turn your iPhone or Vision Pro spatial videos into SBS 3D video for 3DTVs and VR goggles.

🖼️

Spatial Photo → SBS Image NEW

Convert spatial photos to SBS still images in JPEG, PNG, TIFF, or HEIC format. Mixed folders with video and photos are processed in one pass.

🥽

SBS Video → Spatial Video

Convert your existing SBS 3D video into Apple Vision Pro spatial video format, with adjustable stereo parameters.

🖼️➡️🥽

SBS Image → Spatial Photo NEW

Convert SBS still images into spatial photos (HEIC) viewable in Apple Vision Pro. FOV, stereo baseline, and disparity are fully adjustable.

🔍

Spatial Media Inspector Updated

Instantly check whether any video or photo file is spatial media, and view its embedded FOV, stereo baseline, and disparity parameters.

🎵

Audio Track Preserved

Audio is automatically copied to the output video. Supports AAC, MP3, AC3, and more. Not applied to photo conversions.

How to Use

Getting started

Choose a conversion direction

Select either Spatial Video/Photo → SBS or SBS → Spatial Video/Photo. The settings panel updates automatically to match your choice.

Set the input — folder or files

Drag and drop a folder onto the input area, or click the "Select…" button to choose files or a folder.

💡 Video and photo files can be mixed in the same folder: The app automatically detects each file type — videos (MOV, MP4, M4V, etc.) and photos (HEIC, HEIF, JPG, PNG, TIFF, etc.) are each converted to the appropriate output format. Multi-file drag & drop and individual file selection are also supported.

Set the output folder

Specify where converted files should be saved. Using a separate folder from the input is recommended. Output filenames are automatically suffixed with _sbs (for Spatial→SBS) or _spatial (for SBS→Spatial).

Adjust options (optional)

Configure output format, quality, resize options, and stereo parameters. The defaults work well for most cases.

Click "Start Conversion"

A progress dialog shows live file and frame progress. You can cancel at any time. A summary dialog appears when conversion completes.

💡 Direction mismatch warning: If the app detects a potential mismatch between your selected direction and the input files (e.g., spatial videos detected when "SBS → Spatial Video/Photo" is selected), a warning dialog will appear before conversion starts, giving you a chance to correct the direction.

Features

Settings & Features

🔍 Spatial Media Inspector

Click the "Check Spatial" button (next to the input selector) to inspect any video or photo file. If the file is spatial media, the app displays its embedded parameters — useful for matching settings when converting SBS content back to spatial format.

Horizontal FOV

The horizontal field of view recorded in the file (in degrees). Works for both video and photo.

Stereo Baseline

The distance between the left and right camera lenses (in mm). Works for both video and photo.

Disparity Adjustment

The horizontal disparity adjustment value recorded in the file (in %). Works for both video and photo.

💡 If the selected file is not spatial media, the app displays "Not a Spatial Video/Photo." Use this to verify that files exported from the Photos app were saved correctly.

📤 Output settings (Spatial Video/Photo → SBS)

Separate format options are available for video and photo outputs.

Video Format

Choose from MP4 (H.264), MP4 (H.265/HEVC), or MOV (HEVC).
H.264 offers the widest compatibility; H.265 produces smaller files at the same quality.

Photo Format NEW

Choose from JPEG, PNG, TIFF, or HEIC.
JPEG for broad compatibility, PNG/TIFF for lossless quality, HEIC for Apple devices.

Compression Quality

Adjust from 0–100% with the slider. Applies to both video and photo outputs.

Half-Width (Half-SBS)

Enable this for 3DTVs that use "Half-SBS" mode. Applies to both video and photo outputs.

📥 Output settings (SBS → Spatial Video/Photo)

The following parameters apply to both video and photo conversions. Spatial photos are always output as HEIC.

Horizontal FOV

Default: 63.4° (close to the iPhone standard camera). Use the "Check Spatial" button to find the original FOV if converting back from a known spatial source.

Disparity Adjustment

Default: 2.00%. Higher values increase the perceived depth.

Stereo Baseline

Default: 19.24 mm (matches the measured iPhone lens separation). Adjust to reflect your source camera.

🔧 Common settings

Swap L/R

Swap the left and right eye channels. Use this if your SBS source has the eyes in the wrong order.

Copy Audio

Include the original audio track in the output video. Not applied to photo conversions. Supports AAC, MP3, AC3, and more.

Resize

Enable to specify an output size. The value you enter is the resolution of a single eye. For example, entering 600×600 produces a 1200×600 standard SBS output, or a 600×600 Half-SBS output. Applies to both video and photo.

Resize Mode

Stretch (ignore aspect ratio) · Crop & Fill (scale to fill, center-crop) · Letterbox (scale to fit, add black bars). Applies to both video and photo outputs.

📊 Live progress

A dedicated dialog shows per-file progress and elapsed time in real time (video also shows per-frame progress). Files that don't match the selected direction are automatically skipped.

Important

⚠️ Important Notes

⚠️ Exporting spatial video/photo from the Photos app

When you drag a spatial video or spatial photo out of the macOS Photos app, it is automatically converted to standard 2D media. This file is no longer spatial and cannot be converted correctly by this app.

To export the original spatial media, use this method:

Select the spatial video or photo in Photos
Click File in the menu bar
Choose Export → Export Unmodified Original
Select a destination folder and export

After exporting, use the "Check Spatial" button to verify the file was saved correctly as spatial media.

🔍 Verifying spatial video with QuickTime Player

You can also verify a spatial video using QuickTime Player:

Open the file in QuickTime Player
Choose Window → Show Movie Inspector (or press ⌘I)
If the Format field shows MV-HEVC or Spatial Video, the file is a spatial video

If it only shows "H.264" or "HEVC", the file has been converted to 2D. You can also use the built-in "Check Spatial" button in this app for a quick check (works for photos too).

💡 AVI files: AVI video may have dimensions that are not multiples of 16, which can cause conversion errors. When AVI files are included in the input, the app will automatically suggest enabling the resize option. A resolution such as 1920×1080 (multiples of 16) is recommended.