How to Verify an H.264 MVC MKV Before Playing It on Vision Pro

An MKV file with H.264 video may be a compatible 3D MVC source for Lumair, or it may contain ordinary 2D H.264 video. Check the stream structure first, then test the file in Lumair's Vision Pro preview before you rely on it for a full movie.

Lumair can open compatible local files through Files, connect directly to SMB, and connect to a user's Jellyfin server. For compatible H.264 MVC video in MKV, Lumair decodes the MVC stream and converts it on the device to stereo MV-HEVC for the visionOS system player. This is a playback conversion path, not direct MVC playback.

A file's `.mkv` extension, codec label, size, bitrate, filename, and metadata are useful clues. None guarantees that the file contains both views or that it will play correctly. The final check is stereoscopic output in the headset.

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

Start With the File Structure, Not the Filename

An MKV is a container. It can hold video, audio, subtitles, chapters, and other tracks. The container does not identify the video format with enough precision to confirm 3D playback.

H.264, also called AVC, is a video codec family. An H.264 file may be a conventional 2D video file. It may also use H.264 MVC, short for Multiview Video Coding. MVC carries a base view plus information for a dependent view. Together, those views can create a stereoscopic image.

The base view is the primary H.264 picture. A decoder can often display that base view as ordinary 2D video. The dependent view contains image data that relates to the second eye's perspective. It does not behave like a separate, complete movie file. The decoder combines the base and dependent data to reconstruct the two views.

This structure differs from side-by-side and top-bottom video:

A file called `Movie.3D.MVC.mkv` may be correctly named, but its name does not prove the dependent view is present. A file identified as H.264 in a media library may still be 2D. Treat labels as starting points for inspection.

What to Check Before You Put the File on Vision Pro

Check the file's stream information in the software you already use to manage your own media. Look for evidence that the video is MVC or multiview, rather than relying on the filename or the MKV extension.

Useful details include:

• A video label that identifies MVC, multiview AVC, or a 3D MVC stream.
• A base H.264/AVC view with associated dependent-view information.
• A runtime that matches the title you expect.
• The intended audio and embedded subtitle tracks.
• A resolution and frame rate that match the source you expect.

These details help you identify the file. They do not guarantee playback. Metadata readers can expose incomplete, inconsistent, or application-specific labels. Version labels can also differ between media tools and server libraries. One app may say “H.264,” while another may identify MVC details. Use those labels to decide what to test, then verify the result in Lumair.

Do not use any single surface detail as a pass/fail test:

• Container: An MKV can contain 2D H.264, H.264 MVC, HEVC, and many other video types.
• Codec name: “H.264” alone does not confirm MVC.
• File extension: `.mkv` describes the container only.
• File size and bitrate: Large files can be 2D, and smaller files can retain multiview data.
• A “3D” filename: The label may describe the title, a prior workflow, or a library naming convention.
• Library badges: Server and media-library badges depend on their own metadata and codec detection.

If the available stream information clearly identifies only one ordinary H.264 video stream, expect 2D output. If it identifies MVC or multiview information, move to the on-device test. If the information is unclear, the preview is still the practical test.

Know What Lumair Does With Compatible MVC MKV Files

Lumair supports compatible H.264 MVC video in MKV through an on-device conversion path. Lumair decodes MVC and converts it to stereo MV-HEVC for the visionOS system player.

That distinction matters because MVC and MV-HEVC are different multiview video formats. Apple documents MV-HEVC as a format used for multiview and spatial video workflows. Apple Developer

The conversion happens during Lumair's playback preparation. Your source file remains an MVC MKV. Lumair does not turn every MKV into a supported file, and a compatible-looking source can still fail because of its specific video stream, audio, subtitles, file condition, or device playback result.

Lumair also handles some other file paths differently:

• Compatible MP4, MOV, and M4V files that AVFoundation handles use native playback.
• Compatible HEVC MKV files are remuxed while preserving the original HEVC base video.
• Lumair may prepare Dolby Vision when that is safe. When it is not safe, Lumair uses the source HDR10 base layer.
• Dolby Vision behavior depends on the source profile and file. Do not assume every Dolby Vision file will use the same path.

Apple lists supported video technologies and playback capabilities for Apple Vision Pro in its technical specifications. Apple Vision Pro Technical Specifications

Open the Exact Local File You Checked

For a local preflight test, place the file where you can select it in Files on Vision Pro, then open it with Lumair. Apple provides instructions for viewing and managing files and folders on Vision Pro. Use Files on Apple Vision Pro

Use this sequence:

1. Open Files on Vision Pro and locate the exact MKV you inspected.
2. Confirm the filename and runtime so you do not test a different version.
3. Open the file in Lumair.
4. Start Lumair's preview.
5. Choose a scene with foreground objects, background detail, and visible depth cues.
6. Watch the image through both eyes for the result described below.

Lumair's interface labels can change between app versions. Follow the controls shown in the installed version of Lumair. Labels in screenshots, older instructions, or other video apps are clues only.

Lumair plays compatible decrypted 2D and 3D Blu-ray ISO disc images but does not open BDMV folders, bypass DRM, or rip discs. It does not provide DRM bypass or disc-ripping functions. 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. Use Files for compatible local files, connect directly to SMB, or connect Lumair to your own Jellyfin server.

Verify Actual Stereo Output During the Preview

A metadata label cannot confirm that Vision Pro receives a correct stereoscopic result. Use Lumair's preview to check the rendered image.

A successful MVC test has these characteristics:

• You see one image with natural depth.
• Near objects appear closer than distant objects.
• The picture does not show two full images at the same time.
• The scene does not look like ordinary flat 2D video.
• Depth feels correctly oriented when you look at an asymmetric object, readable text, or a character moving toward the camera.

Use a scene with clear depth separation. A wide landscape may look flat even when the video is working because it offers few close objects. A shot with a foreground object crossing in front of a background is more useful.

Keep the preview test focused on video output. A successful image test does not guarantee that every audio track, subtitle format, chapter marker, or seek point will behave the same way throughout the title.

Read the Symptoms Correctly

The Movie Looks Flat

A flat image means you are seeing one view without usable stereoscopic depth. Check the source information again for MVC or multiview details. If the file has only ordinary H.264 video, it is a 2D source.

If the file appears to contain MVC information, test the exact file locally in Lumair through Files. A flat result can also come from a source that does not provide compatible MVC data, a file that is incomplete, or a playback condition Lumair cannot prepare.

Do not assume that “H.264” or “MKV” means the file should display in 3D.

Two Images Appear at Once

Two visible images usually indicate a layout mismatch. The source may be side-by-side or top-bottom video rather than MVC. In those formats, both eye images are already packed into the displayed frame.

Check the source's actual layout. A file can be an MKV and still be SBS or top-bottom. Its container does not resolve the question.

Two images can also indicate that the file is not being interpreted as the stereo format you expected. Confirm the source type before changing settings based on another app's instructions.

Depth Looks Reversed

Reversed-eye output means the left and right views are presented in the wrong order. Near objects can appear to recede, and depth can feel uncomfortable.

Use a scene with readable text, a one-sided object, or a person extending an arm toward the camera. Those details make the orientation easier to judge. Check whether the installed Lumair version provides a control for the result you see. Do not infer available controls from another player or an earlier Lumair version.

Reversed depth still indicates that two views may be present. It does not by itself prove that the source lacks MVC.

The File Does Not Open or Playback Stops

Record the exact file and result before trying another copy:

• File name and storage location
• Container and video labels
• Audio and subtitle track selected
• Lumair version
• What happens in the preview
• Whether the same file opens through Files

This information helps Lumair Support identify whether the issue relates to the source file, its tracks, the local file handoff, or the MVC preparation path. See Lumair Support.

Verify SMB Streams and Downloads or Jellyfin Downloads Before Travel

Lumair can browse, stream, and download compatible video directly from an SMB server on the local network. It can also connect to your Jellyfin server and download the selected original source file unchanged to app-managed storage. Jellyfin documentation describes client codec support and server transcoding behavior, which can vary with the server and client configuration. Jellyfin codec support and Jellyfin transcoding

For a direct SMB preflight:

1. Browse to the exact MVC MKV you inspected and confirm its filename and runtime.
2. Stream it in Lumair and run the same stereo preview test.
3. If you need offline playback, download that exact SMB file in Lumair.
4. Open the SMB download from the local library and repeat the stereo preview.
5. Check the embedded audio and subtitle tracks you expect to use.

A nearby sidecar subtitle is not bundled into an SMB download. Test the downloaded copy itself before relying on it away from the share.

For a Jellyfin download preflight:

1. Download the selected source file in Lumair while you have a connection.
2. Open the downloaded item from the local library.
3. Run the same stereo preview test.
4. Check the embedded audio and subtitle tracks you expect to use.
5. Test seeking and a few scenes before you travel.

Separate external subtitle files are not bundled into Jellyfin downloads. Do this before leaving reliable connectivity. Apple also documents Travel Mode for Apple Vision Pro. Use Apple Vision Pro in Travel Mode

A server listing, codec badge, or successful stream does not prove that a downloaded copy will meet your needs offline. Test the exact stream and every downloaded copy you plan to watch.

Preflight Checklist

Before starting a full movie, confirm the following:

• The file is an MKV containing H.264 MVC or another source format you intend to test.
• Stream labels suggest a base view and dependent MVC view, when that information is available.
• You did not rely on the filename, extension, bitrate, file size, or codec name alone.
• You opened the exact local file through Files, streamed or downloaded the exact SMB file, or tested the exact Jellyfin download.
• Lumair's preview shows one image with visible, natural stereoscopic depth.
• A scene with asymmetrical details confirms the eye order looks correct.
• The audio and embedded subtitle tracks you need work in the streamed, downloaded, or local copy.
• You tested the file before travel if you plan to watch offline.

Lumair provides a 5-minute playback preview for every video. Full Playback is a $14.99 US one-time purchase. App Store pricing can vary by storefront.

Download Lumair free on the App Store.