Update README
This commit is contained in:
@@ -6,6 +6,47 @@ Apollo is a self-hosted desktop stream host for [Artemis(Moonlight Noir)](https:
|
|||||||
|
|
||||||
Refer to LizardByte's documentation hosted on [Read the Docs](https://sushinestream.readthedocs.io/) for now.
|
Refer to LizardByte's documentation hosted on [Read the Docs](https://sushinestream.readthedocs.io/) for now.
|
||||||
|
|
||||||
|
## About Virtual Display
|
||||||
|
|
||||||
|
> [!WARNING]
|
||||||
|
> ***It is highly recommend to remove any other virtual display solutions from your system and Apollo/Sunshine config, to reduce confusions and compatibility issues.***
|
||||||
|
|
||||||
|
> [!NOTE]
|
||||||
|
> **TL;DR** Just treat your Artemis/Moonlight client like a dedicated PnP monitor with Apollo.
|
||||||
|
|
||||||
|
Apollo uses SudoVDA for virtual display. It featurs auto resolution and framerate matching for your Artemis/Moonlight clients. The virtual display is created upon the stream starts and removed once the app quits. **If you couldn't notice a new virtual display being added or removed when the stream starts/quits, then there might be a misconfiguration of the driver or you're still have other presisting virtual display connected.**
|
||||||
|
|
||||||
|
The virtual display works just like any physically attached monitors with SudoVDA, Windows will remember the monitor position config natively, there's completely no need for a super complicated solution to "fix" resolutions for your monitors. Unlike all other solutions that reuses one identity or generate a random one each time for any virtual display sessions, Apollo assigns a fixed identity for each Artemis client, or use a dedicated identity each app if using other Moonlight clients.
|
||||||
|
|
||||||
|
## Configuration for dual GPU laptops
|
||||||
|
|
||||||
|
Apollo supports dual GPUs seamlessly.
|
||||||
|
|
||||||
|
If you want to use your dGPU, just set the `Adapter Name` to your dGPU and enable `Headless mode` in `Audio/Video` tab, save and restart your computer. No dummy plug is needed any more, the image will be rendered and encoded directly from your dGPU.
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
- **No virtual display added**
|
||||||
|
- Ensure the SudoVDA driver is installed
|
||||||
|
- **Shows the same screen as main screen**
|
||||||
|
- If you're using an external display for the first time, Windows might configure it as "Mirror mode" by default. Press <kbd>Meta + P</kbd> (or known as <kbd>Win + P</kbd>) and select "Extended", then **exit the app** (not only the stream) and start the app again. You only need to do this once.
|
||||||
|
- **Primary display changed to the virtual display after connection. I don't want that.**
|
||||||
|
- Go to Apps and add one entry without any commands. Tick `Always use Virtual Display`, then untick `Set Virtual Display as Default`.
|
||||||
|
- **Resolution can't match client side anymore**
|
||||||
|
- ***NEVER*** set screen rotation on virtual displays! Widecar can handle vertical display normally, there's no need to manually set screen rotatition if you're using [Artemis](https://github.com/ClassicOldSong/moonlight-android) with Widecar.
|
||||||
|
- If you happen messed up with your monitor config:
|
||||||
|
1. Disconnect ALL Artemis/Moonlight sessions
|
||||||
|
2. Quit Apollo
|
||||||
|
3. <kbd>Meta(Win) + R</kbd>, then type `regedit`, hit enter
|
||||||
|
4. Delete ALL entries under
|
||||||
|
- `HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\GraphicsDrivers\Configuration`
|
||||||
|
- `HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\GraphicsDrivers\Connectivity`
|
||||||
|
- `HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\GraphicsDrivers\ScaleFactors`
|
||||||
|
|
||||||
|
This will clear your monitor configuration cache.
|
||||||
|
|
||||||
|
Then you're good to go!
|
||||||
|
|
||||||
## System Requirements
|
## System Requirements
|
||||||
|
|
||||||
> **Warning**: This table is a work in progress. Do not purchase hardware based on this.
|
> **Warning**: This table is a work in progress. Do not purchase hardware based on this.
|
||||||
@@ -58,6 +99,8 @@ SudoVDA: Virtual Display Adapter Driver used in Apollo
|
|||||||
|
|
||||||
[Artemis](https://github.com/ClassicOldSong/moonlight-android): Integrated Virtual Display options control from client side
|
[Artemis](https://github.com/ClassicOldSong/moonlight-android): Integrated Virtual Display options control from client side
|
||||||
|
|
||||||
|
**NOTE**: Artemis currently supports Android only. Other platforms will come later.
|
||||||
|
|
||||||
## Support
|
## Support
|
||||||
|
|
||||||
Currently support is only provided via GitHub Issues.
|
Currently support is only provided via GitHub Issues.
|
||||||
|
|||||||
Reference in New Issue
Block a user