Umbral GitHub

Development builds

Linux virtual desktops that work better over a remote connection.

Syzygy hosts the desktop. Eclipse and Occultation connect to it from another Linux computer or an Android device.

Host
Linux
Clients
Linux, Android 5.0+
Based on
Apollo, Moonlight
Status
Early development
on the Linux host
curl -fsSL https://raw.githubusercontent.com/NotADeveloper4665/Syzygy/main/scripts/install-syzygy.sh | bash
syzygy -s -auto
syzygy -psk

Components

Three projects that work together: one host and two clients.

How they fit

The host and a client are paired once. After that the client reconnects on its own.

  1. Run Syzygy on the Linux machine

    This is the computer whose desktop you want to reach. It can be headless.

  2. Install a client

    Eclipse on another Linux computer, or Occultation on Android.

  3. Pair with the six-word phrase

    Add the host by address or discovery, then enter the phrase from syzygy -psk. Over your own Tailscale network, the phrase can be skipped.

  4. Connect

    The client saves a certificate, not the phrase, and uses it for every later connection.

Screenshots

The first three are real screenshots from development builds. The ones marked with an asterisk are illustrations.

Install the host

Syzygy on Linux. The source installer supports apt, dnf, zypper, pacman and apk systems.

source installer
curl -fsSL https://raw.githubusercontent.com/NotADeveloper4665/Syzygy/main/scripts/install-syzygy.sh | bash

It installs build dependencies, builds the latest main, creates your host key and prints the start command, syzygy -s -auto. It asks for sudo only to install packages or write under /usr/local, and leaves the server stopped. Set SYZYGY_BRANCH to pick a branch or tag. You can read the script before running it.

Fedora 44 x86_64 · development RPM
curl -fsSL https://raw.githubusercontent.com/NotADeveloper4665/Syzygy/main/scripts/update-syzygy-dev-rpm.sh | bash

Installs the rolling build from the dev release. The updater checks the checksum and your Fedora version and CPU, then installs with dnf. It keeps your configuration and pairing keys and leaves running servers alone. Start it with /usr/bin/syzygy so you get the RPM, not an older source install.

headless, no monitor or login
curl -fsSL https://raw.githubusercontent.com/NotADeveloper4665/Syzygy/main/scripts/install-syzygy.sh | SYZYGY_INSTALL_HEADLESS=1 bash
syzygy -s -auto -headless -psk

Starts a private KDE Wayland desktop that works over SSH. The default size is 1920x1080; set SYZYGY_HEADLESS_SIZE=2560x1440 to change it. The installer adds the runtime automatically on Fedora only. Other distributions need the runtime programs from the README installed by hand. Reconnect SSH after install if it added you to the render group.

Install Eclipse

The Linux desktop client. Download from the dev release, which carries a Fedora 44 x86_64 RPM, an x86_64 Flatpak, the source, and checksums.

Fedora RPM
sha256sum -c SHA256SUMS --ignore-missing
sudo dnf install ./moonlight-eclipse-VERSION.x86_64.rpm
Flatpak
flatpak install --user ./Eclipse-VERSION-x86_64.flatpak
flatpak run io.github.notadeveloper4665.Eclipse

Use the file names you downloaded in place of VERSION, and install the main RPM, not the debuginfo or debugsource ones. The Flatpak needs Flatpak set up with Flathub. Its sandbox hides the host's Tailscale service, so Tailscale discovery and the microphone, webcam and USB forwarding actions don't work there. You can still connect to a Tailscale host by typing its address. A versioned 0.5.6 preview is also available.

Install Occultation

The Android client. It needs Android 5.0 or newer, and installs next to Artemide, Artemis and Moonlight.

Download universal APK All development APKs

The universal APK covers ARMv7, ARM64, x86 and x86-64. The release page also lists CPU-specific APKs. These are debug-signed development builds, not production releases. A signing-key change means older development APKs may need to be uninstalled first.

build from source · Java 17, Android SDK 36, NDK 27.0.12077973
git submodule update --init --recursive
./gradlew :app:assembleNonRoot_gameDebug

Pairing

Anyone who holds the phrase can pair with full host permissions. Share it only with devices you trust.

Development builds

All three are early. Builds update when checks pass on main.