Support

Standard MP4/MOV files (H.264 and HEVC), including 8K. Content types: VR180 (side-by-side or over-under stereo), 360° equirectangular (mono or stereo), and regular flat video — 2D or 3D.

Containers Apple's media stack doesn't open — MKV, WebM, AVI, WMV — won't play. Remuxing such a file into an MP4 usually takes seconds and doesn't re-encode the video.

• Album — pick from your Photos library. Videos you AirDrop to the Vision Pro land here.
• On Device — the app's own folder. In the Files app, look under On My Vision Pro › VR Video Player and drop videos in; tap the refresh button in the app.
• Choose Folder — browse to any folder (iCloud Drive, a mounted share, …) and play from there.
• Network Share — connect your NAS in the Files app first (tap ⋯ in the top-left of its sidebar, choose Connect to Server, enter smb://…), then pick the share's folder here.
• Media Server — browse a DLNA/UPnP server on your network. Type its address once and the app remembers it, so next time it's one tap.

No — VR Video Player samples the actual frames and detects the stereo layout (side-by-side, over-under, or 2D) and the projection (180° / 360° / flat) automatically when a video loads.

Some files are ambiguous — for example, a flat 2:1 video is indistinguishable from a 360° one by size alone. While playing, tap the globe button in the controls and pick 180° dome, 360° sphere, or Flat screen. The geometry rebuilds instantly, without reloading the video.

The button always shows which mode is in force: Auto · 180° means detection chose it, a plain Flat means your choice is holding. An override applies to the video you're watching; the next video starts on Auto again, and picking Auto mid-video hands it straight back to detection.

If a clip is shot on a green screen, VR Video Player detects that automatically and keys the green out in real time — the subject appears in your actual room instead of a green void. Tap the Green Screen button (it glows green when active) to toggle keying or fine-tune the Low/High thresholds while you watch.

Detection looks for large areas of pure chroma green, which natural foliage doesn't reach — but edge cases exist. The Green Screen toggle overrides the detection either way.

Yes — that's the Background button in the controls. Pick any second video and it loops behind your keyed clip, so the subject appears on a beach, a stage, or anywhere else instead of in your room. Its volume sits relative to the main video, and a meter warns you before a combination exceeds what the headset can decode.

You can pick that background from the same places as any other video, including the Photos album, a folder, or a media server.

Yes. In Flat screen mode, pinch and drag the screen to move it anywhere in the room — it turns to face you as you move it sideways, and stays upright. Pinch with both hands to resize it, and double-tap it to put it back where it started. Where you leave it is remembered as you switch between videos.

The 180° dome and 360° sphere stay centred on you by design, so those can't be dragged — use the Digital Crown to recentre the view instead.

Yes — the hand button in the controls. Normally your hands break through the video when you raise them, which is what you want while reaching for something. Turn it off and the video covers them instead, which is less distracting during a long immersive clip. The setting is remembered.

Tap Done in the top-left of the playback controls (or press the Digital Crown). You'll be back at the library to pick the next file.

Please tell us — with the file's resolution, frame rate and codec. Stuttering isn't something you should have to work around, and we'd rather fix the player than have you re-encode your library.

It's worth saying what the hardware can do, because expectations are often set too low: Apple Vision Pro (M2) has run an 8K green-screen clip in this player with a second 8K video playing behind it — two simultaneous 8K streams, keyed and composited live — with no observable degradation. So if a single video stutters, something specific is wrong with that file or that situation, and we want to see it.

No. Videos play entirely on-device. Nothing is uploaded to us — we run no servers and collect no data. See the privacy policy for the full picture.

They're optional integrations for advanced setups — they let the app send playback timing and scene information to equipment you run on your own network (for example, smart-light controllers). They're off by default, and nothing is sent unless you enter an address and enable them.

Two extra switches sit beside each address, both off unless you turn them on: Send video name, so a worker can match its own scripts to what you're watching, and Allow playback control, which lets that worker send play, pause, skip and seek back to the player. Building one? The wire format and reference workers are on the developer page.

Files sitting next to a video with the same name but a different extension — like concert.srt or concert.roll.funscript next to concert.mp4. Everything after the video's name is passed along as the file's type, so multi-axis or multi-track companions keep their qualifier.

They can live in either of two places, and workers can use either:

• On the device, sent with the session. When you play from a folder source, the app finds the sidecars next to the video and sends their contents to the Script and Lighting integrations as the session opens.
• On the worker itself. A worker can keep its own library and choose the right file when a video starts — that's what the optional Send video name setting is for. It passes the video's name only, never its path or contents, so the worker can match.

Videos picked from the Photos album have no folder to look in, so they carry no sidecars — a worker with its own library still works.