Apollo README

The project's README from github.com/ClassicOldSong/Apollo. As one markdown file: README.md.

Apollo

Apollo is a self-hosted desktop stream host for Artemis(Moonlight Noir). Offering low latency, native client resolution, cloud gaming server capabilities with support for AMD, Intel, and Nvidia GPUs for hardware encoding. Software encoding is also available. A web UI is provided to allow configuration and client pairing from your favorite web browser. Pair from the local server or any mobile device.

Major features:

Usage

Refer to LizardByte's documentation hosted on Read the Docs for now.

Currently Virtual Display support is Windows only, Linux support is planned and will be implemented in the future.

About Permission System

Check out the Wiki

[!NOTE] The FIRST client paired with Apollo will be granted with FULL permissions, then other newly paired clients will only be granted with View Streams and List Apps permission. If you encounter Permission Denied error when trying to launch any app, go check the permission for that device and grant Launch Apps permission. The same applies to the situation when you find that you can't move mouse or type with keyboard on newly paired clients, grant the corresponding client Mouse Input and Keyboard Input permissions.

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 features 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 do not see a new virtual display added or removed when the stream starts or stops, there may be a driver misconfiguration, or another persistent virtual display might still be active.

The virtual display works just like any physically attached monitors with SudoVDA, there's completely no need for a super complicated solution to "fix" resolution configurations for your devices. 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/Moonlight client, so your display configuration will be automatically remembered and managed by Windows natively.

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.

About HDR

HDR starts supporting from Windows 11 23H2 and generally supported on 24H2. Some systems might not have HDR toggle on 23H2 and you just need to upgrade to 24H2. Any system lower than 23H2/Windows 10 will not have HDR option available.

[!NOTE] The below section is written for professional media workers. It doesn't stop you from enabling HDR if you know what you're doing and have deep understanding about how HDR works.

Apollo and SudoVDA can handle HDR just fine like any other streaming solutions.

If you have had good experience with HDR previously, you can safely ignore this section.

If you're curious, read on, but don't blame Apollo for poor HDR support.

Whether HDR streaming looks good, it depends completely on your client.

In short, ICC color correction should be totally useless while streaming HDR. It's your client's job to get HDR content displayed right, not the host. But in fact, it does affect the captured video stream and reflect changes on devices that can handle HDR correctly. On other devices that can't, the info is not respected at all.

It's very complicated to explain why HDR is a total mess, and why enabling HDR makes the image appear dark/yellow. If it's your first time got HDR streaming working, and thinks HDR looks awful, you're right, but that's not Apollo's fault, it's your device that tone mapped SDR content to the maximum of the capability of its screen, there's no headroom for anything beyond that actual peak brightness for HDR. For details, please take a look here.

For client devices, usually Apple products that have HDR capability can be trusted to have good results, other than that, your luck depends.

DEPRECATION ALERT

Enabling HDR is generally not recommended with ANY streaming solutions at this moment, probably in the long term. The issue with HDR itself is huge, with loads of semi-incompatible standards, and massive variance between device configurations and capabilities. Game support for HDR is still choppy.

SDR actually provides much more stable color accuracy, and are widely supported throughout most devices you can imagine. For games, art style can easily overcome the shortcoming with no HDR, and SDR has pretty standard workflows to ensure their visual performance. So HDR isn't that important in most of the cases.

How to run multiple instances of Apollo for multiple virtual displays

Follow the instructions in the Wiki.

FAQ

Moved to WiKi

Stuttering Clinic

Here're some common causes and solutions for stutters: WiKi.

Device specific setups

System Requirements

Warning: This table is a work in progress. Do not purchase hardware based on this.

Minimum Requirements

Component Description
GPU AMD: VCE 1.0 or higher, see: obs-amd hardware support
Intel: VAAPI-compatible, see: VAAPI hardware support
Nvidia: NVENC enabled cards, see: nvenc support matrix
CPU AMD: Ryzen 3 or higher
Intel: Core i3 or higher
RAM 4GB or more
OS Windows: 10+ (Windows Server requires manual installation for gamepad support)
macOS: 12+
Linux/Debian: 11 (bullseye)
Linux/Fedora: 39+
Linux/Ubuntu: 22.04+ (jammy)
Network Host: 5GHz, 802.11ac
Client: 5GHz, 802.11ac

4k Suggestions

Component Description
GPU AMD: Video Coding Engine 3.1 or higher
Intel: HD Graphics 510 or higher
Nvidia: GeForce GTX 1080 or higher
CPU AMD: Ryzen 5 or higher
Intel: Core i5 or higher
Network Host: CAT5e ethernet or better
Client: CAT5e ethernet or better

HDR Suggestions

Component Description
GPU AMD: Video Coding Engine 3.4 or higher
Intel: UHD Graphics 730 or higher
Nvidia: Pascal-based GPU (GTX 10-series) or higher
CPU AMD: todo
Intel: todo
Network Host: CAT5e ethernet or better
Client: CAT5e ethernet or better

Integrations

SudoVDA: Virtual Display Adapter Driver used in Apollo

Artemis: Integrated Virtual Display options control from client side

NOTE: Artemis currently supports Android only. Other platforms will come later.

Support

Currently support is only provided via GitHub Issues/Discussions.

No real time chat support will ever be provided for Apollo and Artemis. Including but not limited to:

When there's a chat, there're dramas. -- Confucius

Downloads

Direct Download

Recommended

Releases

WinGet

Note: Community maintained

In an elevated PowerShell window, run

winget install ClassicOldSong.Apollo

You'll need WinGet installed first.

Chocolatey

Note: Community maintained

You can also install the apollo streaming server with chocolatey.

Install Chocolatey if you don't have it, then run the following command in an elevated PowerShell/CMD window:

choco upgrade apollo -y

Same command can be used to upgrade, add to a scheduled task to automate updates.

See more details on the chocolatey package here

Disclaimer

I got kicked from Moonlight and Sunshine's Discord server and banned from Sunshine's GitHub repo literally for helping people out.

This is what I got for finding a bug, opened an issue, getting no response, troubleshoot myself, fixed the issue myself, shared it by PR to the main repo hoping my efforts can help someone else during the maintenance gap.

Yes, I'm going away. Apollo and Artemis(Moonlight Noir) will no longer be compatible with OG Sunshine and OG Moonlight eventually, but they'll work even better with much more carefully designed features.

The Moonlight repo had stayed silent for 5 months, with nobody actually responding to issues, and people are getting totally no help besides the limited FAQ in their Discord server. I tried to answer issues and questions, solve problems within my ability but I got kicked out just for helping others.

PRs for feature improvements are welcomed here unlike the main repo, your ideas are more likely to be appreciated and your efforts are actually being respected. We welcome people who can and willing to share their efforts, helping yourselves and other people in need.

Update: They have contacted me and apologized for this incident, but the fact it happened still motivated me to start my own fork.

License

GPLv3

Apollo (ClassicOldSong/Apollo)

Searching Database…

11.3K ·GitHub
Apollo
Что это такое?Apollo — самостоятельно развёртываемый хост для стриминга игр с ПК, форк Sunshine, созданный для работы с клиентом Artemis (Moonlight Noir). Он обеспечивает потоковую передачу с низкой задержкой в родном разрешении вашего устройства с аппаратным кодированием на GPU.
Чем это отличается от Sunshine или Moonlight?Apollo — жёсткий форк Sunshine, созданный после того, как автора забанили в исходном сообществе Sunshine/Moonlight за помощь пользователям. Со временем он будет отходить от основного проекта. Кроме того, у него есть собственный клиент (Artemis), фиксированные идентификаторы виртуальных дисплеев для каждого клиента и система прав доступа, которой нет в оригинальном Sunshine.
Как мне это запустить?Скачайте готовый релиз напрямую с GitHub или, на Windows, установите его через WinGet или поддерживаемый сообществом пакет Chocolatey. После установки откройте веб-интерфейс в браузере, чтобы настроить параметры и подключить клиенты Artemis/Moonlight.
Какое железо нужно, чтобы всё работало плавно?Нужна видеокарта с поддержкой кодирования (AMD VCE 1.0+, Intel VAAPI или Nvidia NVENC), процессор как минимум уровня Ryzen 3 / Core i3, 4 ГБ+ оперативной памяти и Wi-Fi 802.11ac на частоте 5 ГГц на хосте и клиенте. Программное кодирование тоже доступно, если поддерживаемой видеокарты нет.
Работает ли функция виртуального дисплея и на macOS, и на Linux?Нет, встроенный Virtual Display (на базе SudoVDA) пока работает только в Windows. Поддержка Linux запланирована, но ещё не реализована. Качество стриминга HDR сильно зависит от обработки HDR на стороне самого клиента, а не от Apollo.
Можно ли запустить хост на macOS или Linux, или это только для Windows?Хост-программа работает на Windows 10+, macOS 12+ и Linux (Debian 11+, Fedora 39+, Ubuntu 22.04+). Однако функции с двумя видеокартами и виртуальным дисплеем пока доступны только в Windows.
Что такое Artemis и нужен ли он мне?Artemis — сопутствующий клиент Apollo, форк Moonlight Noir. Пока он доступен только на Android, поддержка других платформ запланирована. Чтобы начать стриминг, его нужно подключить к Apollo.
Какие права получает только что подключённый клиент?Первый клиент, подключённый к Apollo, автоматически получает все права. Каждый следующий клиент по умолчанию получает только «View Streams» и «List Apps», поэтому такие права, как Launch Apps, Mouse Input или Keyboard Input, новым устройствам нужно выдавать вручную.
Можно ли запустить несколько виртуальных дисплеев одновременно?Да, можно запустить несколько экземпляров Apollo для управления несколькими виртуальными дисплеями. Шаги настройки описаны в Wiki проекта.
What are similar projects?Sunshine, moonlight-qt, neko, bloodborne_pc, QtScrcpy, pyrowave, srs, d4r
Which topics is it in?low-latency, amd-gpu, remote-desktop, remote-control, video-streaming, webui, gpu-acceleration, hardware, gaming, streaming, vue, nvidia
Creator
ClassicOldSong
Size
34.4 MB
Stars
11.3K
Updated
CommitMay 21Releasev0.4.6Jul 13
Age
2y
Commits · 90 Days