Lumair
← All guides

3D playback

How to Watch 3D Movies on Apple Vision Pro

Use Apple TV for eligible 3D titles or Lumair for compatible personal files, SMB shares, and Jellyfin media on Apple Vision Pro.

By Eduard Borges

Apple Vision Pro has two separate 3D movie workflows:

  1. Apple TV 3D titles, which you watch in the Apple TV app.
  2. Personal files, which you open locally or stream from your own SMB share or Jellyfin server with a compatible player.

Start by choosing the source. Apple TV purchases and rentals stay in Apple’s app. Files from your own collection require a player that can recognize the video format and stereo layout. Lumair is built for compatible local files, SMB shares, and personal Jellyfin libraries on Apple Vision Pro.

Lumair includes no media. You are responsible for having the rights to any files you open or stream. Lumair is not affiliated with Jellyfin.

Watch Apple TV 3D Movies

Use the Apple TV app for titles Apple makes available in 3D. Open the app, find an eligible movie, and select the 3D playback option on its details page. Apple documents eligible 3D titles and the Play in 3D control in its Vision Pro user guide: Watch Apple Immersive Video and 3D movies.

This path is for store and streaming titles tied to your Apple account. It does not turn a personal movie file into an Apple TV 3D title.

Apple Vision Pro can also download eligible Apple TV content for offline viewing. Check the title’s download availability before travel, then test playback while you still have an internet connection. Apple’s Travel Mode guidance also applies when you plan to use Vision Pro during a flight: Use Apple Vision Pro in Travel Mode.

Choose the Right Workflow for Personal 3D Files

For personal media, identify the file before selecting a playback route. The relevant details are the video encoding, the container, and the way the left and right views are stored.

Use this decision path:

  • MV-HEVC file: Open it locally in Lumair when the file is compatible.
  • H.264 MVC video in an MKV file: Use Lumair’s MVC workflow. Lumair decodes compatible MVC video and converts it on device to stereo MV-HEVC for the visionOS system player.
  • Side-by-side (SBS) file: Use a player workflow that recognizes SBS presentation.
  • Over-under (OU) file: Use a player workflow that recognizes top-and-bottom presentation.
  • Personal SMB share: Connect Lumair to a compatible SMB server on your local network, then stream or download the exact compatible file you want.
  • Personal Jellyfin library: Connect Lumair to your own Jellyfin server, then stream or download a compatible source file.
  • Apple TV 3D purchase or rental: Use the Apple TV app instead.

A filename, extension, bitrate, or codec label does not guarantee playback. Two files called “MVC MKV” can differ in video tracks, metadata, audio, subtitles, HDR layers, and source structure. Test the specific file you plan to watch.

For deeper format guidance, including supported local-file and server workflows and current limitations, see Lumair Support.

Identify MVC, MV-HEVC, SBS, and OU Files

H.264 MVC in MKV

MVC, or Multiview Video Coding, is an H.264 format commonly associated with Blu-ray 3D sources. It stores a base view and a dependent second view.

Lumair supports compatible H.264 MVC video in MKV. It does not play MVC directly in the visionOS system player. Instead, Lumair decodes the compatible MVC source and converts it on device to stereo MV-HEVC for the system player.

This path applies to compatible files only. Lumair plays compatible decrypted 2D and 3D Blu-ray ISO disc images but does not open BDMV folders, bypass DRM, or rip discs. Open a compatible decrypted Blu-ray ISO directly, or prepare another supported file through a lawful workflow.

MV-HEVC

MV-HEVC is a multiview HEVC format used for spatial and stereoscopic video. Compatible MV-HEVC files use the native visionOS playback path.

Apple provides technical documentation on multiview HEVC and the conversion of side-by-side 3D video into multiview HEVC: Converting side-by-side 3D video to multiview HEVC and spatial video.

A file with “HEVC” in its name is not automatically MV-HEVC. Standard single-view HEVC video and multiview HEVC video are different source types.

Side-by-Side (SBS)

A side-by-side file stores both eye views next to each other in one frame. If a player treats that frame as normal 2D video, you will see two images beside each other.

Use the SBS presentation option for a file that is known to be side-by-side. Confirm whether the file uses full-width or half-width SBS when you inspect its source information. The player still needs to recognize the source and present it correctly.

Over-Under (OU)

An over-under file, also called top-and-bottom, stacks one eye above the other. A player that reads it as 2D shows two vertically stacked images.

Choose the OU presentation path only when the file uses that layout. SBS and OU are not interchangeable. Selecting the wrong layout can produce a double image, stretched picture, or incorrect depth.

Open Local Files on Apple Vision Pro

Lumair can open compatible local files through the Files app on Apple Vision Pro. First place the file somewhere Files can access, then choose it from Lumair.

Apple documents how to view and manage files on the headset in View, modify, and organize files and folders.

Before you settle in to watch a full movie, run a short test:

  1. Open the exact file you plan to watch.
  2. Start playback and confirm that Vision Pro shows one stereoscopic image.
  3. Check that the depth looks correct.
  4. Test the audio and subtitle tracks you need.
  5. Seek to another scene to confirm the file remains stable.

Compatible MP4, MOV, and M4V files that AVFoundation handles use native playback in Lumair. Compatible HEVC MKV files are remuxed for playback while preserving the original HEVC base video. Lumair may prepare Dolby Vision when it is safe to do so. When that is not safe, it uses the source HDR10 base layer instead.

That behavior does not guarantee Dolby Vision, HDR, subtitles, audio, or playback for every profile and file. Test the source on your device.

Lumair can browse, stream, and download compatible video directly from SMB servers on the local network. It does not claim NFS, DLNA, WebDAV, Plex, or Emby support. For server-based playback, connect directly through SMB or use a supported Jellyfin connection. Use Files for media already stored locally on Vision Pro.

Stream Personal 3D Movies From SMB or Jellyfin

Direct SMB and Jellyfin are separate supported server routes in Lumair. Choose the route that matches how your library is exposed.

Stream directly from SMB

Lumair can connect to a compatible SMB server on the local network. Sign in, choose a share, browse to the exact 3D file, and test its stereoscopic presentation before relying on the server path.

For a direct SMB streaming session:

  1. Confirm that Vision Pro can reach the SMB server on the local network.
  2. Connect in Lumair, sign in, and choose the intended share.
  3. Select the exact compatible 3D file.
  4. Play a short section and check the stereoscopic presentation.
  5. Use a tested SMB download if you need playback away from the share.

Stream from Jellyfin

Lumair can connect to your own Jellyfin server. After you sign in, browse the available library, select the correct version of the movie, and start playback.

If your library contains both a 2D version and a 3D version, verify the selected item before you press play. Server metadata and filenames can help you identify versions, but they do not replace a playback test.

Jellyfin’s documentation explains that codec support and transcoding behavior depend on the client, server, media type, and configuration: Jellyfin client codec support and Jellyfin transcoding.

For a Jellyfin streaming session:

  1. Connect Lumair to your Jellyfin server.
  2. Choose the intended movie version.
  3. Confirm that the selected source is the 3D file.
  4. Play a short section and check the stereoscopic presentation.
  5. Use a tested Jellyfin download if your network or server connection is unreliable.

Lumair supports direct SMB and Jellyfin connections. It does not connect to Plex or Emby.

Download SMB or Jellyfin Files for Offline Playback

Lumair can download compatible video from SMB or a selected original source file from Jellyfin to app-managed storage. SMB downloads retain the source information needed for retry and playback. A Jellyfin download remains the selected original source file, and Lumair does not transcode it into another file for the download.

Embedded tracks remain with the downloaded media. Separate external subtitle files are not bundled into SMB or Jellyfin downloads. If you rely on an external subtitle file, test the downloaded movie before you travel.

Download before a flight, hotel stay, or other period without dependable access to your SMB or Jellyfin server. Then test the downloaded copy in Lumair while you still have time to resolve a problem.

Check these items before leaving:

  • The download completed.
  • The selected SMB file or Jellyfin version is the intended 3D source.
  • The movie opens from app-managed storage.
  • The stereoscopic image displays correctly.
  • Required embedded audio and subtitle tracks are available.
  • You have enough device storage for the downloaded file.

Do not assume that a successful download guarantees playback. A source may still contain an unsupported video profile, HDR configuration, audio track, subtitle format, or stereo arrangement.

Test Whether 3D Presentation Is Working

A working 3D presentation should appear as one image with depth. Use a scene with foreground and background objects, subtitles, or clearly separated subjects to check the effect.

Common results point to different issues:

  • A single flat image: The source may be 2D, the second view may not be available, or the wrong version may be selected.
  • Two images side by side: An SBS file is playing as 2D.
  • Two images stacked vertically: An OU file is playing as 2D.
  • A doubled or uncomfortable image: The selected SBS or OU layout may be wrong, or the source may not match the expected format.
  • No depth from an MVC source: Confirm that the file is compatible H.264 MVC video in MKV and reopen it through Lumair’s MVC workflow.

The deeper Lumair support guides cover format-specific checks. Use them when you need to inspect an MVC MKV, distinguish SBS from OU, or confirm an MV-HEVC source.

Troubleshoot Flat or Double 3D Output

Start with the source, then check the route you selected.

The Movie Plays Flat

Confirm that you selected a 3D version of the title. Jellyfin libraries often include a separate 2D copy. A standard HEVC file may also be ordinary 2D video rather than MV-HEVC.

For MVC, confirm that the source is compatible H.264 MVC video in an MKV container. A compatible decrypted Blu-ray ISO uses Lumair’s disc-image playback path; BDMV folders and other disc-derived structures remain unsupported.

For SBS and OU, make sure the file is not being treated as normal 2D video.

The Movie Shows Two Images

Two horizontal halves usually indicate SBS video without the correct stereo presentation. Two vertical sections usually indicate OU video without the correct presentation.

Check the actual layout of the file. Do not choose SBS because the movie looks doubled, or OU because the image looks wrong. Match the selected layout to the source layout.

Streaming Fails but a Local File Works

Compare the streamed version with a downloaded copy of the same selected source. If the download works, inspect the SMB connection, local-network reachability, authentication, and share permissions, or inspect the Jellyfin server availability and any server-side transcoding behavior.

If neither copy works, the file itself may not fit the supported playback path. Check Lumair Support and test another compatible version if you have one.

Subtitles or Audio Are Missing

Select another embedded track if the player makes one available. For SMB or Jellyfin downloads, remember that Lumair retains embedded tracks but does not bundle separate external subtitle files. Test the downloaded file before relying on it away from home.

Start With the Workflow That Matches Your Source

Use the Apple TV app for eligible Apple 3D titles. Use Lumair for compatible personal files through Files, direct SMB, or a personal Jellyfin server. Choose local playback, an SMB download, or a Jellyfin download when you need offline access.

Lumair is free to download and includes a 5-minute playback preview per video for testing your files. Full Playback is a $14.99 US one-time purchase. App Store pricing can vary by storefront.

Download Lumair free on the App Store.