Umbra · host
Stream your games and desktop from a Windows or Linux PC. Umbra is Apollo with the additions Eclipse needs for co-op, and as little else changed as possible.
Umbra’s additions use AI-assisted coding. About the development process.
Open the latest release, expand Assets and choose the package described below. If no release is listed, that package has not been published.
Choose the Windows x64 installer .exe in the latest release’s Assets. Install on each Windows gaming PC, including its bundled virtual-display and device components. Administrator access is needed for installation; no separate device-bridge download is required.
Already using Apollo? Umbra and Apollo replace one another; they are not side-by-side installations. Umbra deliberately keeps the Apollo installation folder and registry identity for in-place upgrades. Back up your host configuration and pairings before switching. Installing Apollo again replaces Umbra and removes access to Umbra-specific co-op features.
Windows 11 x64 with NVIDIA RTX 4070 / RTX 3070 and AMD Radeon RX Vega is the current physical test base. Umbra for Linux is a Flatpak (below), tested on Ubuntu 26.04 with KDE Plasma and GNOME on an NVIDIA RTX 2060 SUPER and an AMD Radeon RX Vega. macOS is not a release target.
Download an attached file under Assets, not GitHub’s automatically generated Source code (zip) or Source code (tar.gz). Those are developer archives, not installable apps. Use the latest compatible stable release. If no package is attached for your platform, that download is not available.
Exact Windows host installation →Open the Umbra for Linux release and expand Assets. If no release is listed, that package has not been published.
Download Umbra-<version>-linux-x86_64.flatpak from the Umbra for Linux release and install it with flatpak install --user. KDE Plasma and GNOME on Wayland get ordinary streaming, a virtual display for each stream and co-op; X11 desktops get ordinary streaming only. Optional extras add HDR to KDE’s and GNOME’s virtual displays: patches to KWin 6.6.6 and Mutter 50.1, with prebuilt packages for Ubuntu 26.04. The only AMD card tested is a 2017 Radeon RX Vega, whose encoder limits 4K to about 60 fps.
Umbra comes in two versions: Umbra, built on Apollo, and Umbra (Vibepollo), built on Vibepollo. Both carry the same additions for Eclipse; they differ only in the host they are built on. Choose the one built on the host you would otherwise use.
| Umbra | Umbra (Vibepollo) | |
|---|---|---|
| Built on | Apollo (ClassicOldSong) | Vibepollo (Nonary), itself built on Apollo |
| Platforms | Windows x64, Linux (Flatpak) | Windows x64 |
| Installer | Windows installer .exe; Linux Flatpak bundle | Vibepollo’s setup, with its MSI package |
| Replaces in place | Apollo | Vibepollo, Apollo or Umbra, keeping configuration and pairings |
| Status | Released; the tested version | Released (2.0.0-umbra.1) and tested on the project’s test PCs |
Umbra (Vibepollo) keeps everything Vibepollo adds over Apollo as Vibepollo ships it, including its own virtual display and virtual gamepad drivers, and Vibepollo’s RTX HDR support, which uses NVIDIA’s TrueHDR runtime under NVIDIA’s own licence terms. Until code signing is set up, its virtual gamepad driver is signed with Umbra’s own certificate, which the installer adds to the PC’s trusted certificates.
It follows Vibepollo’s releases the way Umbra follows Apollo’s, with the additions kept apart so Vibepollo updates can be merged in. It is an independent fork; report problems with it to Umbra (Vibepollo), not to Vibepollo.
Open the latest release, expand Assets and choose the package described below. If no release is listed, that package has not been published.
Choose the Windows x64 installer Umbra-Vibepollo-windows-x64.exe in the latest release’s Assets.
Apollo, by ClassicOldSong and contributors, supplies the everyday host experience, built on Sunshine. Umbra keeps that foundation and adds the host-side encoder, session coordination and integration Eclipse needs. It is not a rewrite of Apollo.
Umbra keeps its additions and branding in separate files wherever possible, so Apollo updates can be merged with fewer conflicts. The aim is to follow Apollo’s development, not replace it; an Apollo update still needs to be integrated and tested in Umbra.
The Umbra panel in the host’s web interface identifies the installed Umbra build and its recorded Apollo release base. Its update notice compares published releases; it does not prove that every newer Apollo commit has been included. Install Umbra releases to retain Eclipse’s co-op additions.
Apollo resource links lead to Apollo’s own pages. For this fork, report problems to Umbra, not to Apollo’s maintainers.
Umbra supplies the custom encoder and capability negotiation needed to make compatible co-op streams across different GPU vendors. Eclipse handles joining the streams, presentation and player assignments.
Co-op defaults are separate from regular streaming. The Co-op Pane is built into Umbra and requested automatically by Eclipse; it is not an entry you need to create in the host’s Applications page.
The complete project and system map →Use the installed host shortcut or tray action to open configuration, set up the local login and approve Eclipse’s pairing PIN. Test one ordinary session from each PC before starting co-op.
