← All guides

Jellyfin & home servers

How to Stream Your Own Movies to Apple Vision Pro from Jellyfin or a Home Server

Watch Jellyfin on Apple Vision Pro with Lumair: stream compatible home-server movies, download offline, and understand supported 3D, HDR10, and Dolby Vision paths.

Watch Jellyfin on Apple Vision Pro: the short answer

Yes. A compatible client can browse and play Jellyfin content on Apple Vision Pro. The practical choice depends on how you access Jellyfin, whether you also play local files, whether you need offline downloads, whether you want stereoscopic 3D, how HDR and Dolby Vision files are handled, and whether you need direct network-file protocols. Lumair is an independent Apple Vision Pro media player for media you own or are authorized to play; it includes no movies or shows and is not affiliated with Jellyfin. Its documented workflows include local Files, direct SMB access, and connections to your own Jellyfin server for compatible media.

Apple Vision Pro supports specified codecs and HDR formats at the platform level. Lumair adds its own workflows on top: Jellyfin-library access, direct SMB access, local-file playback, offline downloads, and supported stereoscopic presentation. Keeping that distinction clear helps you predict whether a given file will play.

What visionOS supports natively and what Lumair adds

Apple lists HEVC, MV‑HEVC, H.264, AV1, HDR with Dolby Vision, HDR10, and HLG among the Apple Vision Pro video-playback formats [1]. Apple's documented local-file workflow uses iCloud Drive or AirDrop and Quick Look; Apple's Mac encoding guidance recommends MV‑HEVC for 3D stereoscopic video and HEVC for other video [2].

Lumair adds media-library access on top of those platform capabilities. The table separates what visionOS supports at the codec level from what Lumair documents as an app-level workflow. "Not supported" here means not established as a native visionOS capability or a documented Lumair workflow in this guide. It is not a claim about every possible app or a future visionOS release.

CapabilityvisionOS-native statusLumair statusImportant boundary
Jellyfin browsing and playbackNot supported/not specifiedLumair-addedConnects to your own Jellyfin server for compatible media only
Jellyfin offline downloadsNot supported/not specifiedLumair-addedDownloads remain subject to the same compatible-file limits
Local filesvisionOS-native (Files/Quick Look)Lumair-addedLumair opens local files; not every file variant is guaranteed
Compatible H.264 MVC video in MKVNot supported/not specifiedLumair-addedConverted on device for the system player; compatible files only
Compatible MV‑HEVCvisionOS-nativeLumair-added (direct playback)Applies to compatible MV‑HEVC files
Side-by-side/over-under 3DNot supported/not specifiedLumair-addedNot every resolution, layout, or metadata variant is recognized
HDR10visionOS-nativeLumair-added (compatible HEVC MKV REMUX)Compatible files only; not every container or profile
Dolby Vision handlingvisionOS-nativeLumair-added (compatible HEVC MKV REMUX)Handling of compatible files; not every Dolby Vision profile
Subtitles/audio controlsvisionOS-native controlsLumair-added track selectionCompatible embedded PGS and SRT, plus sidecar SRT for SMB media using Lumair's processing path

How do I watch Jellyfin on Apple Vision Pro?

The workflow uses only supported actions:

  1. Install Lumair on Apple Vision Pro.
  2. Connect the app to your own Jellyfin server, using your existing server configuration and credentials.
  3. Browse your library.
  4. Select compatible media and play it.

This section covers Jellyfin browsing and playback through Lumair. Lumair can also connect directly to SMB servers on the local network, but it does not claim NFS, DLNA, WebDAV, Plex, or Emby support.

Connect your own Jellyfin library

Use the Jellyfin server you already run. Lumair connects to it and reads your library. Set up your server, remote access, and credentials through Jellyfin's own tools; this guide does not prescribe server-address entry, authentication, transcoding, or network configuration. If you already reach your Jellyfin library from other devices, that same server is what Lumair connects to.

Browse and play compatible media

Once connected, browse the library and pick titles to play. Playback works when the media matches one of Lumair's documented compatible workflows described later in this guide. Treat the "best" choice as a match to your library rather than a universal ranking. Families who want to watch family movies on Vision Pro from a home server can browse a shared Jellyfin library the same way, provided the files are compatible.

Can I download Jellyfin movies for offline viewing?

Yes. As introduced in the short answer, Lumair supports offline downloads of compatible media. Download the items you want before you lose your server connection, then play them locally when the server is unavailable.

Download before you are offline

Browsing and playing from a connected Jellyfin library needs a live server connection. A downloaded compatible file does not. Download while you have access, so a compatible title is ready when you travel or lose network access. The supplied facts do not specify download quality choices, storage requirements, download locations, or DRM behavior, so plan around your own device storage.

Check compatibility before downloading

Offline availability does not remove format compatibility requirements. A downloaded item still needs to fit one of Lumair's compatible playback paths described later in this guide. Test the downloaded copy before you rely on it away from your server, because streaming and local playback can take different paths.

What video formats work from a home server?

Think about this by playback type rather than a "plays everything" list. The result depends on the codec, the container, and whether the file is 2D HDR or stereoscopic 3D.

2D and HDR-compatible files

Lumair documents playback of compatible HEVC MKV REMUX files with HDR10 and Dolby Vision handling. The word "compatible" matters. Dolby Vision handling is not a promise that every Dolby Vision profile, every MKV file, or every server configuration will play. These are ordinary 2D HDR characteristics.

Stereoscopic 3D files

For stereoscopic playback, Lumair supports compatible H.264 MVC video in MKV files, which it converts on device for the visionOS system player. This is Lumair-added processing, not native MKV or MVC support from Apple. Lumair also supports compatible MV‑HEVC direct playback, and Apple lists MV‑HEVC among supported Vision Pro formats [1]. MV‑HEVC is a multiview HEVC format that carries stereo views in separate layers, as explained by 360 Labs [3]. Side-by-side and over-under files are supported through Lumair's spatial-presentation workflow, though not every resolution, layout, or metadata variant will be recognized.

HDR10 or Dolby Vision does not make a video stereoscopic. A 3D file still needs a supported stereoscopic format and presentation path. Keep 2D HDR and stereoscopic 3D as separate questions when you check a file.

Why container and codec details matter

The same movie can exist in containers and codecs that Lumair handles differently. Use this checklist as decision guidance, not diagnostic or transcoding instructions:

  1. Identify whether the item is local, opened from SMB, streamed from Jellyfin, or downloaded.
  2. Identify its codec and container, and whether it is 2D HDR or stereoscopic.
  3. Confirm it fits one of Lumair's documented compatible workflows.

For Vision Pro NAS media streaming, a NAS-hosted library can reach Lumair directly through SMB or through your own Jellyfin server. NFS and other unlisted network protocols remain unsupported.

Media typeDocumented playback path3D or 2D resultCompatibility caveat
Compatible HEVC MKV REMUX with HDR10Quality-preserving playback through Lumair2D HDRCompatible files only; not every container or profile
Compatible HEVC MKV REMUX with Dolby Vision handlingQuality-preserving playback through Lumair2D HDRHandling of compatible files; not every Dolby Vision profile
Compatible H.264 MVC in MKVOn-device conversion for the system playerStereoscopic 3DCompatible MVC MKV files only; not every MKV
Compatible MV‑HEVCDirect playback (Apple-supported format)Stereoscopic 3DCompatible MV‑HEVC files only
Compatible side-by-side 3DSpatial-presentation workflowStereoscopic 3DNot every resolution, layout, or metadata variant
Compatible over-under 3DSpatial-presentation workflowStereoscopic 3DNot every resolution, layout, or metadata variant
Compatible decrypted 3D Blu-ray ISODisc-image playbackStereoscopic 3DEncrypted images and BDMV folders are unsupported

Can Vision Pro play Dolby Vision from a server?

Apple lists HDR with Dolby Vision and HDR10 in Vision Pro's supported video-playback formats [1], and Lumair handles compatible HEVC MKV REMUX files with those formats as described above.

Native HDR support versus server playback

The platform supporting a format does not mean a specific server stream will play. Whether Vision Pro Dolby Vision from a server works through Jellyfin depends on the particular media being compatible with Lumair's documented workflow. This guide does not promise that every Dolby Vision profile, container, audio track, subtitle combination, server transcode, or network condition will succeed.

What Lumair's Dolby Vision handling means

Dolby Vision and HDR10 handling concerns 2D HDR playback characteristics. It is separate from stereoscopic 3D support. A compatible Dolby Vision file in Lumair's documented workflow plays as 2D HDR; it is not stereoscopic because it uses Dolby Vision. Keep those two properties distinct when you judge whether a title will play the way you expect.

Choose Lumair when its documented workflow matches your library

Treat the best Jellyfin client for visionOS as a fit-based decision, not a universal ranking. The best app for streaming from a home server to Vision Pro depends on the workflow and compatibility you need.

A fit for Jellyfin, local files, and supported 3D

Lumair is a relevant choice when you need its documented combination: local Files, direct SMB browsing, streaming, and downloads, Jellyfin browsing and offline downloads, compatible MVC MKV stereoscopic playback, compatible MV‑HEVC direct playback, side-by-side and over-under presentation, and compatible HEVC MKV REMUX HDR handling. If that set matches your library, Lumair covers it.

When another workflow may be necessary

If you specifically require Plex integration, a non-SMB network-file protocol, BDMV folder playback, DRM bypass, disc ripping, or a format not documented here, do not assume Lumair provides it. Those needs fall outside the documented scope, and a different workflow may be necessary.

Important limits before you start

Scan these limits before you install or purchase:

  • Lumair is for media you own or are authorized to play. It includes no movies or shows.
  • All playback claims here apply to compatible files only. There is no universal format-compatibility promise.
  • Compatible decrypted 2D and 3D Blu-ray ISO disc images are supported; encrypted images and BDMV folders are not.
  • Lumair supports direct SMB and Jellyfin connections. This guide makes no claim of Plex integration or non-SMB network-file protocols such as NFS, DLNA, or WebDAV.
  • The product scope does not include DRM bypass or disc-ripping instructions or functionality.
  • Apple's platform-supported formats do not automatically mean a particular server stream, container, 3D layout, or file variant is supported by Lumair [1].

Try Lumair with your compatible library

Download Lumair, inspect your library, and test compatible playback rather than assuming every file will work. Download Lumair free on the App Store and use the included 5 minutes of actual playback per video to test compatible media; Full Playback is a one-time $14.99 purchase with no subscription. Full Playback can be restored through Apple. Use the included minutes to check that your compatible files play the way you need before you unlock Full Playback.

Frequently asked questions

Does Lumair include movies or TV shows?

No, as stated in the short answer above; Lumair ships with no movies or shows, and you supply the library through local files, an SMB server, or your own Jellyfin server.

Is Lumair affiliated with Jellyfin?

No, as noted in the short answer above; Lumair connects to your own Jellyfin server to browse and play compatible media, but is not affiliated with the project.

Does Lumair require a subscription?

No. As noted above, Lumair downloads free with 5 minutes of playback per video, and Full Playback is a one-time $14.99 purchase with no subscription that can be restored through Apple.

Does Lumair support Plex or direct NAS protocols?

Lumair supports direct SMB access and Jellyfin libraries. It does not claim Plex, NFS, DLNA, or WebDAV integration.

Can Lumair play 3D ISO files?

Yes, when the source is a compatible decrypted 3D Blu-ray ISO disc image. Lumair also plays compatible H.264 MVC in MKV or MK3D, MV‑HEVC, and side-by-side or over-under video. BDMV folders and encrypted disc images remain unsupported.

Does Lumair bypass DRM or provide disc-ripping instructions?

No, as noted in the limits above; Lumair is intended for media you own or are authorized to play.