Moonlight for VisionOs/iOS/tvOS is an open source client for Sunshine and NVIDIA GameStream. Moonlight for iOS/tvOS allows you to stream your full collection of games and apps from your powerful desktop computer to your iOS device or Apple TV.
It also supports a Sunshine fork called Apollo which on Windows supports a Built-in Virtual Display with HDR support that matches the resolution/framerate config of your client automatically.
Moonlight also has a PC client and Android client.
Check out the Moonlight wiki for more detailed project information, setup guide, or troubleshooting steps. Also check out the discord
The Vision OS Version is not available in the App Store, to download the latest stable-ish build please install it via Testflight
- Curved Screen Support (Reality Kit Mode) ** To actiavte change the Renderer in settings to Reality Kit (note mouse and keyboard not supported in this mode at the moment)
- SBS 3d support (in Reality Kit Mode only, it is one of the side buttons)
- I wanted to give special thanks to tht7, ALVR for Vision Pro's shinyquagsire23, Giovanni Petrantoni (sinkingsugar) from Formabble and dereklucas for their contributions to Moonlight XrOS"
- Reality Kit HDR Support is now in beta, it mostly works but YMMV on color accuracy. More options to control HDR will likely be added later. (sinkingsugar)
- SBS Support added to Reality Kit Mode (it is a new button in the reality kit volume side bar) (dereklucas)
- support for AppIntents! (Shortcut support) that allow users to directly launch into the StreamView if you've already paired (by accessing saved apps directly without opening the mainview). You should now be able to apps like 'Steam Big Picture' directly to their home screen (tht7)
- Fixed error messages so that app won't crash on connection or disconnection issues (tht7)
- Many optimizations for opening streams so it is now so much faster to connect to a server (tht7)
- Fixed issues with double volumes opening on slow connections (tht7)
- UI Optimizations (default to selecting to computer for example) (tht7)
- Perfomrance optimizations (shinyquagsire23)
- Edge shimmering on reality kit view should be resolved (shinyquagsire23)
- Sometimes selecting a differing computer host doesn't load the app data, you may have to go back to the settings tab and back to refresh it.
- HDR is noteably broken on UiKit, Colors might not be perfect on Reality Kit, we are looking into adding some additional options to help adjust this
- Deleting a PC causes a crash when PC scanning is on (or an app scan is trying to refresh), after deleting a computer (for example if you need to repair after installing Apollo or Sunshine) just force quit and re-open and you will be fine
- Even though you've already paired a computer, you may see the same computer host again with .local in the name if you turn on scanning
- The app can get really slow if you have multiple hosts saved that aren't online (as it is trying to refresh to see available apps)
- Moonlight XrOS does not know when a computer is ONLINE, only that it's been saved and paired or it hasn't been paired yet
- Controller Vibration isn't working, we are looking into this
- According to user reports, PS4 touch pad does not work
- Uikit mode in moonlight supports keyboard and mouse, specifically it works very well with the Magic Trackpad. Mice with the Vision Pro can be a little hit or miss but as long as you Bluetooth it and make sure you've enabled the mouse in Vision Pro settings it should work, there are some settings in there you should double check:
- GENERAL -> KEYBOARD and TRACKPAD -> Enable Two Finger Secondary Click or for Magic Mouse enable Secondary Click (Set to Right)
- Why does my cursor snap to where I'm looking - This is an OS level thing, but greatly improved since Vision OS 2.0
- How do I activate Curved Screens?
- In settings, change the renderer to Reality Kit Mode then connect to your host
- How do I Pair?
- You can add a computer with the + button, or you can try to scan for hosts using the scan for hosts text in the computers list. *If you have trouble with load times, try deleting hosts that are not online
- How do I use SBS?
- In reality kit mode, use the rectangle button toggle above the height adjust
- How do I use Ultrawide Mode?
- In settings set the resolution to 5120x1440, then set up Apollo or a virtual display driver / dumy plug and set the same settings on windows. In UIKit you can then use the aspect ratio button to fix the black bars, it should just be automatic on Reality Kit Mode. If you already connected with the wrong settings, you have to STOP the stream by long pressing the 'Virtual Display App' and start the stream again to apply the new settings.
- Why is my connection so choppy?
- AWDL (apple wireless direct) is a special feature on apple devices that enable features like AirDrop and Handoff. Unforutenatly this can cause stutters at high bit rates, you can try turning off AirDrop and Continuity features, but it is best to use a 5ghz router with it set to use wifi Ch 149
- How do I use a wired connection?
- You can use a developer strap hooked up to a mac with ethernet and then some additional ifconfig commands
- Alternatively you can do something with a Rapsberry Pi
- I am not providing instrucitons for either but more information can be found here
- Recomended Settings?
- Resolution: 4k
- Aspect Ratio: 16:9
- Framerate: 60
- Bitrate: 50mbps
- Renderer: Reality Kit (unless you need mouse + keyboard use UiKit)
- Ui Kit Settings: Touch Mode Touchscreen
- Ui Kit Settings: On-Screen Controls Off
- Check Ko-Fi for updates
- Some people expressed intrest in donations so:
- I set up a ko-fi for donations! https://ko-fi.com/lumanaire
Thanks again for your support :)
- XCode 16.2
- Tested on Vision OS 2.2, 2.3 and 2.4 Betas
- Install the latest version of Xcode
- Run
git clone -b vision-testflight --recursive https://github.com/RikuKunMS2/moonlight-ios-vision.git- If you've already cloned the repo without
--recursive, rungit submodule update --init --recursive - If you are building someone else's fork replace the part after the -b and the user name in the github link.
- If you've already cloned the repo without
- Open Moonlight.xcodeproj in Xcode (it would download by default to your user folder on MacOS)
- To run on a real device, you will need to locally modify the signing options and add your device:
- Go to the top menu bar, then in 'Window' open Devices and Simulators
- Add your Vision Pro
- In the project select to the folder icon in the sidebar to browser files
- Click on "Moonlight" at the top of the left sidebar
- Under "Targets", select "Moonlight Vision"
- Click on the "Signing & Capabilities" tab
- In the "Team" dropdown, select your name. If your name doesn't appear, you may need to sign into Xcode with your Apple account.
- Change the "Bundle Identifier" to something different (unique). You can add your name or some random letters to make it unique.
- Select your Vision Pro (not the simlator or 'any device' but the one your registered earlier) in the top bar as a target and click the Play button to run. It will start the build and install it to your headset
- If you didn't pay for a developer account you will have to re-install it using x-code every 7 days.
- Uikit mode in moonlight supports keyboard and mouse, specifically it works very well with the Magic Trackpad. Mice with the Vision Pro can be a little hit or miss but as long as you Bluetooth it and make sure you've enabled the mouse in Vision Pro settings it should work, there are some settings in there you should double check:
- GENERAL -> KEYBOARD and TRACKPAD -> Enable Two Finger Secondary Click or for Magic Mouse enable Secondary Click (Set to Right)
- Why does my cursor snap to where I'm looking - This is an OS level thing, but greatly improved since Vision OS 2.0
- How do I activate Curved Screens?
- In settings, change the renderer to Reality Kit Mode then connect to your host
- How do I Pair?
- You can add a computer with the + button, or you can try to scan for hosts using the scan for hosts text in the computers list. *If you have trouble with load times, try deleting hosts that are not online
- How do I use SBS?
- In reality kit mode, use the rectangle button toggle above the height adjust
- How do I use Ultrawide Mode?
- In settings set the resolution to 5120x1440, then set up Apollo or a virtual display driver / dumy plug and set the same settings on windows. In UIKit you can then use the aspect ratio button to fix the black bars, it should just be automatic on Reality Kit Mode. If you already connected with the wrong settings, you have to STOP the stream by long pressing the 'Virtual Display App' and start the stream again to apply the new settings.
- Why is my connection so choppy?
- AWDL (apple wireless direct) is a special feature on apple devices that enable features like AirDrop and Handoff. Unforutenatly this can cause stutters at high bit rates, you can try turning off AirDrop and Continuity features, but it is best to use a 5ghz router with it set to use wifi Ch 149
- How do I use a wired connection?
- You can use a developer strap hooked up to a mac with ethernet and then some additional ifconfig commands
- Alternatively you can do something with a Rapsberry Pi
- I am not providing instrucitons for either but more information can be found here
- Recomended Settings?
- Resolution: 4k
- Aspect Ratio: 16:9
- Framerate: 60
- Bitrate: 50mbps
- Renderer: Reality Kit (unless you need mouse + keyboard use UiKit)
- Ui Kit Settings: Touch Mode Touchscreen
- Ui Kit Settings: On-Screen Controls Off
- Check Ko-Fi for updates
- Some people expressed intrest in donations so:
- I set up a ko-fi for donations! https://ko-fi.com/lumanaire
Thanks again for your support :)