Skip to content

Instantly share code, notes, and snippets.

@KhaosT
Last active February 10, 2026 01:18
Show Gist options
  • Select an option

  • Save KhaosT/e9b60fc0fb99b9f4512759b953cbf38c to your computer and use it in GitHub Desktop.

Select an option

Save KhaosT/e9b60fc0fb99b9f4512759b953cbf38c to your computer and use it in GitHub Desktop.
Guide for using Apple Vision Pro as HDMI display

Displaying HDMI sources on Apple Vision Pro

While it's possible to stream most content to Apple Vision Pro directly over the internet, having the ability to use Apple Vision Pro as an HDMI display can still be useful.

Since Apple Vision Pro does not support connecting to an HDMI input directly or using an HDMI capture card, we have to be a little creative to make this work. NDI provides the ability to stream HDMI content over a local network with really low latency, and it works great with Apple Vision Pro.

This page shows the setup I’m using.

What’s needed

  • HDMI NDI Encoder
    • Personally, I recommend the Kiloview N40, as it supports streaming up to 4K60 while being fan-less, and can use USB-C as a power input.
    • Kiloview N60 comes with more features, but it’s larger and has a fan.
  • Vxio app
    • I made this one, you can also use other NDI monitor apps as well.
    • Separately, Finn made Castaway that makes it possible to use a USB Capture Card + Mac/iPad instead of an NDI encoder. It's a more cost effective option for most people I imagine.

Things to consider

  • To ensure high video quality, an NDI stream typically consumes significantly more bandwidth than a typical H.264/H.265 stream. Before purchasing the encoder, make sure your network can support data transfers at that speed.
    • For 4K60 stream, the bandwidth required is typically around 250~300mbps. If you're having issue to stream smoothly, try go to the encoder's settings page and reduce the streaming quality.
    • You can test this with some free software NDI encoders.
  • Since this setup requires encode and decode the video content, it is not latency free. From my experience, I typically see 3~4 frames (~50ms, same as moonlight based on my measurement) of delay from the content source.

Setup

Setting up an NDI encoder is pretty straightforward. Just connect the device to your local network via Ethernet, supply power, and connect the HDMI input to the encoder.

If the visionOS shows the Local Network permission dialog, and after granting the permission the app still shows searching, you may need to force close the app, and reopen it.

After that, you should be able to see the encoder show up as a source in the Vxio app. Select the source, and you'll get your HDMI display 🎉

Screenshot

Misc

Adjusting audio queue size

Depending on the NDI encoder, the default audio queue size might be too small for some devices. In that situation, try increasing the audio queue size so that the audio no longer experiences abrupt stops between samples.

Disable Multi-TCP

If your Wi-Fi channel is congested, you can try force N40 to use UDP instead of Multi-TCP. In my experience, UDP performs a lot better in those network condition. You can do so from the N40's configuration UI, select NDI Connection -> Multi-TCP Disallowed.

UDP

Portable setup

I was able to make this setup portable by getting one of those mini router (GL.iNet Beryl AX) with a LAN port.

IMG_3978 IMG_3979

#AppleVisionPro #visionOS

@KhaosT
Copy link
Author

KhaosT commented Apr 9, 2025

@haseebrabbani in the next update there is going to have an option to use RealityKit to render the stream, which seems to work with HDR content. Unfortunately based on my testing RealityKit has a different set of bugs which prevents it working for non-HDR content. You might switch between them based on what content you're trying to view.

IMG_0176

@haseebrabbani
Copy link

@KhaosT that would be amazing! as long as there is some option to make the HDR appear non-blurry, that would be much appreciated 🙏💪 is there an ETA on the next update?

@KhaosT
Copy link
Author

KhaosT commented Apr 9, 2025

It’s already out

@haseebrabbani
Copy link

GLORIOUS! thank you 🙏

@Jefe533
Copy link

Jefe533 commented Apr 9, 2025

Thank you @KhaosT for the continued updates! I just tried viewing HDR content in immersive stereo, but the highlights are sitll way too flat (almost like they are double tone-mapped). You can see the difference pretty clearly if you open the stream in "regular" flat mode in Vxio then enter immersive, as you'll see the flat version floating atop the immersive space. The regular version looks wonderfully colorful and bright in P3 ST2084 but the immersive situation is still very dull. The saturation seems correct, however. I also noticed that switching between the two renderers (Reality Kit and the AVP native) made no difference, at least not in immersive mode. I tried toggling this setting while in immersive and also by selecting one or the other, force quitting VXIO, then coming back in. I was a little thrown off by the fact that not check mark appears next to which option you select, which made me wonder if my selection was indeed taking hold.

@KhaosT
Copy link
Author

KhaosT commented Apr 9, 2025

@Jefe533 oh immersive one didn't change because it's a different pipeline and since visionOS refuse to support standard SBS setup, supporting HDR in that is going to be super annoying so I didn't bother.

@Jefe533
Copy link

Jefe533 commented Apr 9, 2025

That's too bad but I understand.

@visionprops5
Copy link

@KhaosT Please can you make a full guide how to enable hdr on ps5? I have a Kiloview n60 and have downloaded the latest firmware but ps5 says you’re tv does not support hdr?

@visionprops5
Copy link

@KhaosT I managed to get HDR enabled using the Edid hdr4k60 settings you linked, but like others previously mentioned the colours are washed out & grey. When you use colour over ride the image is blurry.

Decided to switch to non HDR lol. Hopefully Apple can include a HDMI port on the next Vision Pro.

@LowRiderXR
Copy link

@KhaosT I managed to get HDR enabled using the Edid hdr4k60 settings you linked, but like others previously mentioned the colours are washed out & grey. When you use colour over ride the image is blurry.

Decided to switch to non HDR lol. Hopefully Apple can include a HDMI port on the next Vision Pro.

It works perfectly now, if you use the other renderer as mentioned above. HDR makes a huge difference.

@visionprops5
Copy link

Decided to switch to non HDR lol. Hopefully Apple can include a HDMI port on the next Vision Pro.

It works perfectly now, if you use the other renderer as mentioned above. HDR makes a huge difference.

@LowRiderXR @KhaosT When I try to use the other renderer Reality Kit, I only see a black square? I only get an image AVF?

@LowRiderXR
Copy link

LowRiderXR commented Jul 11, 2025

Decided to switch to non HDR lol. Hopefully Apple can include a HDMI port on the next Vision Pro.

It works perfectly now, if you use the other renderer as mentioned above. HDR makes a huge difference.

@LowRiderXR @KhaosT When I try to use the other renderer Reality Kit, I only see a black square? I only get an image AVF?

Sometimes you need to force quit the app entirely and restart the app again. For me it works, but I‘m not yet on VisionOS 26 Beta 3.

@visionprops5
Copy link

Decided to switch to non HDR lol. Hopefully Apple can include a HDMI port on the next Vision Pro.

It works perfectly now, if you use the other renderer as mentioned above. HDR makes a huge difference.

@LowRiderXR @KhaosT When I try to use the other renderer Reality Kit, I only see a black square? I only get an image AVF?

Sometimes you need to force quit the app entirely and restart the app again. For me it works, but I‘m not yet on VisionOS 26 Beta 3.

I’ve tried force quitting the app but reality kit renderer is only a black square, what firmware are you on your kiloview n60? I’m on the latest July 2025 firmware and maybe that’s the issue?

@LowRiderXR
Copy link

Decided to switch to non HDR lol. Hopefully Apple can include a HDMI port on the next Vision Pro.

It works perfectly now, if you use the other renderer as mentioned above. HDR makes a huge difference.

@LowRiderXR @KhaosT When I try to use the other renderer Reality Kit, I only see a black square? I only get an image AVF?

Sometimes you need to force quit the app entirely and restart the app again. For me it works, but I‘m not yet on VisionOS 26 Beta 3.

I’ve tried force quitting the app but reality kit renderer is only a black square, what firmware are you on your kiloview n60? I’m on the latest July 2025 firmware and maybe that’s the issue?

I‘m using the 20241203 firmware version, ndi hb (full channel)

@visionprops5
Copy link

Decided to switch to non HDR lol. Hopefully Apple can include a HDMI port on the next Vision Pro.

It works perfectly now, if you use the other renderer as mentioned above. HDR makes a huge difference.

@LowRiderXR @KhaosT When I try to use the other renderer Reality Kit, I only see a black square? I only get an image AVF?

Sometimes you need to force quit the app entirely and restart the app again. For me it works, but I‘m not yet on VisionOS 26 Beta 3.

I’ve tried force quitting the app but reality kit renderer is only a black square, what firmware are you on your kiloview n60? I’m on the latest July 2025 firmware and maybe that’s the issue?

I‘m using the 20241203 firmware version, ndi hb (full channel)

I’ve figured it out. You have to be using a colour over ride to not get a black square on the Reality Kit renderer.

Finally got HDR working yesterday and playing PS5 on a cinema size screen in bed is amazing!!!

@xNiixo
Copy link

xNiixo commented Oct 2, 2025

Hey @KhaosT first of all, I am in love with your app! It's really nice to use it on the Apple Vision Pro. I was wondering if you could implement KVM Support for NDI Sources which supports it, like a screen capture from a PC. Do you mind that would be possible? I am a student from Germany and currently trying to get NDI with KVM to the Apple Vision Pro because I need it as a part of my bachelor thesis to get a specific system run correctly. I am not that experienced in coding stuff, that's why I'm not trying to do it by myself with an own app. Maybe you can help me out? Thank you very much in advance!

@KhaosT
Copy link
Author

KhaosT commented Oct 3, 2025

@xNiixo Glad you found the app useful. Unfortunately, NDI KVM supports requires their commercial SDK which I'm not able to license.

@lnguyen
Copy link

lnguyen commented Oct 25, 2025

I got an m5 and vxio is very smooth with n60 and 4k hdr

@chrise86
Copy link

Decided to switch to non HDR lol. Hopefully Apple can include a HDMI port on the next Vision Pro.

It works perfectly now, if you use the other renderer as mentioned above. HDR makes a huge difference.

@LowRiderXR @KhaosT When I try to use the other renderer Reality Kit, I only see a black square? I only get an image AVF?

Sometimes you need to force quit the app entirely and restart the app again. For me it works, but I‘m not yet on VisionOS 26 Beta 3.

I’ve tried force quitting the app but reality kit renderer is only a black square, what firmware are you on your kiloview n60? I’m on the latest July 2025 firmware and maybe that’s the issue?

I‘m using the 20241203 firmware version, ndi hb (full channel)

I’ve figured it out. You have to be using a colour over ride to not get a black square on the Reality Kit renderer.

Finally got HDR working yesterday and playing PS5 on a cinema size screen in bed is amazing!!!

How do you find the latency? I’m not looking to play anything competitively on there, but things like Ghost of Yotei would be amazing on there if the latency doesn’t get in the way.

@lnguyen
Copy link

lnguyen commented Oct 27, 2025

This is what I’m playing right now. It’s pretty amazing. M5 got rid of any lag I had before. So I’m starting to think it wasn’t a WiFi issue but a hevc decoding issue that lag slightly sometimes.

@chrise86
Copy link

This is what I’m playing right now. It’s pretty amazing. M5 got rid of any lag I had before. So I’m starting to think it wasn’t a WiFi issue but a hevc decoding issue that lag slightly sometimes.

Oh interesting! So there's no perceivable lag now?

@lnguyen
Copy link

lnguyen commented Oct 27, 2025

No lag at all. I wanted to try m5 to see if it would help. It helped a lot and now I’m selling my m2. Also note. I’m playing in another room and no lag with game and controls.

@pavloPL
Copy link

pavloPL commented Nov 21, 2025

I have been using Vxio app with Kiloview N60 + AVP M5 + my home receiver with bunch of stuff: PS 5 Pro, Xbox Series X, Apple TV, 4K Blu ray player, Nintendo Switch 2.
All works, surprisingly you can watch 4K Blu Rays, play games all in 4K 60fps and HDR flawlessly.

I decided to choose NDI HB codec to setup N60's stream with a 10bit Colour Depth, Auto Colour format. On Vxio you need to set "PQ ST2084 P3 D65" to process HDR image correctly. You need 300-400 Mbps Wifi speed to keep up, but you can choose lower quality with less bandwidth if image stutters. AVP is capable of 700 Mbps so is not an issue on that side.

I have tried NDI HX codec with H.265 and 10bit which works in app as well. It uses less bandwidth around 20-30Mbs but the image stutters a bit, need to drop sometimes quality to Low to make it smooth. I think is a limit on M5 processing as this is a heavy codec. I tried NDI viewer on Mac and works fine so looks like AVP issue.
H.264 codec with 10bit doesn't work in the app, it displays green image.
NDI HX3 doesn’t work for me, there are some encoding artifacts.

With consoles you need to update EDID with HDR support. The default EDID makes console not able to detect it as HDR display.
The one HDR4k_60.bin mentioned above is good enough for PS 5 but does not work for Xbox as this is too generic EDID. I have compared it with Kiloview's original one and modify N60's in a way that should trigger HDR for all PS 5/Xbox/Switch/4K Blu ray player into HDR mode.
Here is a link if anyone wants to use it: https://www.icloud.com/iclouddrive/048eyeG1qL1h7HFuMNwdcGLPQ#N60-HDR

You can plug a HDFury Arcane2 between receiver's output and Kiloview input. I use it to convert Dolby Vision to HDR 10, which HDR 10 and HLG are only supported by N60.

In that case you might want to use EDID which makes display Dolby Vision compatible so you can use this one:
https://www.icloud.com/iclouddrive/002CZKzaUUBsIY7ZGCq2R5r7Q#N60-DV

Lag added to the system is around 100ms from NDI documentation, but for me is not noticeable when I compare it with an OLED TV side by side, you can play fast paced games.

Other than that is such a pleasure to watch and play on a gigantic screen. The AVP screens are truly remarkable, unlike anything. Perfect blacks, no crashed shadow details, no moire, great sharpness from left to right, top to bottom, HDR.

@pavloPL
Copy link

pavloPL commented Jan 11, 2026

@KhaosT would you consider adding some virtual environments like Cinema room or full screen curved screen?
I wouldn’t mind to pay for that extra to improve the experience.

@sparkpeter
Copy link

Thank you for creating this, greatly appreciated. I'm after some help please. I've got a Kiloview N60 and a Vision Pro M5.

  1. Video seems to run smooth for a few seconds then goes stutters a bit then catches up. I'm using wired GigE to a Wi-Fi 5 (802.11ac) router. The Kiloview is reporting a bitrate of ~220-260mbit/sec. I think this should be fast enough? Would I be better buying a GL.iNet Beryl AX in addition and connecting to that via WiFi6?

  2. I'm trying to input a 4k HDR (HLG) HDMI source. I've tried both the EDID's linked above by @pavloPL and neither seem to work with this. The first triggers HDR but the colours aren't right. The 2nd triggers HDR (PQ) and while closer, the colours still aren't right. Is anyone able to provide me with a EDID that will trigger the HDR (HLG) correctly?

Thanks!

@pavloPL
Copy link

pavloPL commented Feb 5, 2026

Thank you for creating this, greatly appreciated. I'm after some help please. I've got a Kiloview N60 and a Vision Pro M5.

  1. Video seems to run smooth for a few seconds then goes stutters a bit then catches up. I'm using wired GigE to a Wi-Fi 5 (802.11ac) router. The Kiloview is reporting a bitrate of ~220-260mbit/sec. I think this should be fast enough? Would I be better buying a GL.iNet Beryl AX in addition and connecting to that via WiFi6?
  2. I'm trying to input a 4k HDR (HLG) HDMI source. I've tried both the EDID's linked above by @pavloPL and neither seem to work with this. The first triggers HDR but the colours aren't right. The 2nd triggers HDR (PQ) and while closer, the colours still aren't right. Is anyone able to provide me with a EDID that will trigger the HDR (HLG) correctly?

Thanks!

  1. Try to benchmark your network, eg use app on iPhone and Vision Pro for testing network bandwidth like iPerfman.
    If your results are more than 300Mb/s than is not a network issue. If less probably you need to tinker with settings, making sure you have 5GHz network enabled and connected, wide channels 160Mhz or at least 80Mhz, etc.

  2. For HLG you need to change colour profile in Vixio for the stream to be: Rec. 2100 HLG and Default 2D Renderer: RealityKit. Then it will show colours correctly.

@sparkpeter
Copy link

Thanks for your help.

  1. Upgrading to a dedicated Beryl AX seems to have made it better. It's not perfect and I'm still getting occasional stutters but it's much better. On the N60 I'm using NDI HB (No Record), default quality 10 bit colour depth, auto color format. In connection I have "Multi-TCP Disallowed".

  2. This is still not working correctly for 4K HDR (HLG) unfortunately. I'm trying to pass through to my TV so my wife can watch on the TV and I can watch on the headset using the TV for volume. The TV without the N60 in the chain displays HDR (HLG) and the picture looks great. When I put the N60 in the chain it disables HDR by default and just displays a non HDR image. Using your iCloud links I can get it to trigger HDR (PQ) but it looks completely off on both the TV and headset. Ideally I need to get it to trigger HDR (HLG) so that the TV it's passing through to will look correct?

@pavloPL
Copy link

pavloPL commented Feb 9, 2026

@sparkpeter I I tested a video out from N60 and TV and yes looks like N60 is not actually passthough original input but output its own signal which is converted to HDR 10 but with HLG colour space. That makes TV to display wrong colours. If you can change a Colour Gamut in your TV to correct one that's great but usually is not possible.

I incorectlly however told you about Colour Override, I checked and it should be: Rec. 2100 HLG I tested with my HLG from Sky box and colours looks right.

IMG_0044

I have a different setup however which can work with watching HLG input on both TV and AVP. You need however an AV receiver with 2 HDMI outputs and than you can setup to output HLG input on both so TV will get original (untouched signal) on Output 1 and you plug N60 to Output 2, something that can look like that:

IMG_0048

@sparkpeter
Copy link

@pavloPL thanks so much for you help!

I'm also using a UK Sky Q HDR (HLG) feed. Setting Vxio to Default 2D Renderer: RealityKit and colour override to Rec 2100 HLG has it looking perfect in my Vision Pro now!

As you mentioned, I now need a HDMI splitter/duplicator which will take 1 HDMI input and then output to two HDMI ports passing the correct HDR (HLG) signal. I don't suppose you know of one? If not, I'll do some trial and error then report back once I find a working solution in case it helps anyone else.

@pavloPL
Copy link

pavloPL commented Feb 9, 2026

@sparkpeter I have at home extra device HDFury Arcana2, which is a multifunction device but it is a splitter as well.
Other function of this device is to allow to convert Dolby Vision to HDR 10 which then can be used on N60.
Just tested the Arcana2 splitting one to TV and one to AVP and does a trick, TV gets the original HLG stream.
Setup sth like that:

IMG_0434

And one more thing when you watch SDR content you need to change Renderer to: AVF and Color Override: Rec. 709, a bit of pain as all this auto settings does not work.

IMG_0050

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment