Preparing and Uploading Content

Before your videos appear in Spatial Player Pro, they need to be in the right format, properly encoded, and placed in a location the app can access. This section walks through the complete content pipeline.

3. Preparing Content

3.1 Supported Video Formats

The app plays 360° equirectangular, VR180, 3D (SBS/OU), and spatial video (MV-HEVC). MV-HEVC is required for native spatial depth on Apple Vision Pro.
FormatDescriptionNotes
360° EquirectangularFull spherical video, standard 2:1 ratioMono or stereoscopic (top/bottom)
VR180180° field of view, stereoscopicRecommended for high-quality depth
3D Side-by-Side (SBS)Left and right eye side by sideStandard 3D format
3D Over-Under (OU)Left eye over right eyeCommon from some cameras
Spatial Video (MV-HEVC)Apple's native spatial video formatRequired for full spatial depth experience

3.2 Video Encoding Methods

For the best experience, encode to MV-HEVC. Use DaVinci Resolve, Handbrake, or FFMPEG depending on your source format.

Option A — DaVinci Resolve (recommended for professional workflows):

  1. Import your 360° or VR180 footage.
  2. In Deliver settings, choose MV-HEVC as the output format.
  3. Set horizontal field of view to 180° (VR180) or 360° (equirectangular).
  4. Enable stereoscopic output if using a dual-lens source.
  5. Export and check the file plays in QuickTime Player on Mac.

Option B — Handbrake (for 360° to H.265 without spatial depth):

  1. Open Handbrake and load your source file.
  2. Choose H.265 (x265) as the video codec.
  3. Set the container to MP4.
  4. Under Video, set a quality RF of 18–22 for a good quality/size balance.
  5. In the Metadata section, add the spherical-video flag if your camera hasn't already done so.

Option C — FFMPEG (command line):

ffmpeg -i input.mp4 -c:v hevc -tag:v hvc1 -c:a aac output.mp4

For MV-HEVC spatial video conversion, refer to Apple's WWDC24 session on spatial video encoding for the exact FFMPEG flags required.

4. Creating 360° Backgrounds

4.1 Equirectangular Panoramas

Your skybox background must be a 2:1 ratio equirectangular JPEG or PNG, minimum 4096×2048 px, maximum 8192×4096 px.

You can create skyboxes from:

5. Creating Icons

5.1 Icon Specifications

Icon typeFormatSize
App logoPNG, transparent background512×512 px or 1024×1024 px
Video thumbnailJPEG or PNG1280×720 px (16:9)
Custom UI iconsPNG, transparent background256×256 px

5.2 Using Templates

The Spatial Player Pro Members Area provides Figma and Adobe Illustrator templates for:

Sign up for the Members Area →

6. Uploading Content

6.1 Organising Your Content

Create a dedicated folder structure: one main folder with sub-folders per presentation or client, containing videos + a thumbnail image each.
SpatialPlayerPro/
  ├── Presentation-A/
  │   ├── video-360.mp4
  │   ├── video-vr180.mp4
  │   └── thumbnail.jpg
  ├── Presentation-B/
  │   ├── walkthrough.mp4
  │   └── thumbnail.jpg
  └── assets/
      ├── logo.png
      └── skybox.jpg

6.2 Uploading to iCloud or Any Other File Transfer Service

Spatial Player Pro can access files from:

For iCloud: open the Files app on your Mac, copy your content folder to iCloud Drive. It will sync automatically to your Apple Vision Pro.

6.3 Accessing the Content from Apple Vision Pro

  1. Open Spatial Player Pro.
  2. Tap Add Content Folder in Settings.
  3. Navigate to your iCloud Drive (or other cloud provider) and select your content folder.
  4. The app will scan the folder and display your videos with their thumbnails.
  5. If a video file is not listed, verify its format is supported (see section 3.1).
← Introduction & Setup App Features →