Repository navigation
Releases
Eclipse 0.5.8 macOS Apple Silicon Test 1
Eclipse 0.5.8 macOS Apple Silicon Test 1
Native arm64 test package for M1 and newer Apple Silicon Macs running macOS 15 or newer. This is a separate prerelease; Fedora RPM and Flatpak downloads remain on their existing tracks.
Combined implementation
Based on Eclipse main b6ba569 and selected macOS behavior from wjbeckett/artemis afe2de7f2b24a2f6161f5672e8aa38450fa793ef (GPL-3.0, upstream attribution retained).
- Retains Eclipse profiles, pairing, control center, statistics and recording code.
- Integrates Artemis's macOS SDL callback-buffer workaround for Bluetooth HFP audio, while retaining Eclipse's WAN audio queue limits.
- Selects native VideoToolbox/Metal by default, following Artemis's macOS preference. Retains Eclipse's newer Metal/HDR/frame-pacing implementation and its AVSampleBufferDisplayLayer fallback, rather than downgrading to Artemis's older renderer.
- Adds Artemis's CoreAudio/AudioUnit framework linkage.
- Native arm64 app, Eclipse bundle identity and independent Mac settings, bundled Qt/FFmpeg/SDL dependencies, ad-hoc signing and a drag-to-Applications DMG.
- Uses one consistent native Homebrew FFmpeg installation, including libavformat for recording. The standard Moonlight dependency archive omits that recording library.
Install and test
Download Eclipse-macOS-arm64-test.dmg, open it and drag Eclipse to Applications. The app is ad-hoc signed and not Apple-notarized. Gatekeeper may require an explicit Open Anyway action in System Settings → Privacy & Security after the first launch attempt. Do not disable Gatekeeper globally.
Start with H.264 or HEVC, hardware decoding and the automatic/native Metal renderer. On M1, AV1 hardware decoding is unavailable; use H.264/HEVC for the hardware path. Check the pipeline/decoder information in stream statistics and the session log.
Verified versus pending
CI checks native arm64 compilation, version startup, native H.264/Opus recording and playback, bundle identity, bundled Mach-O architectures and runtime dependency paths, ad-hoc signature verification, DMG creation, checksums and source provenance. This is not proof of a successful live M1 streaming session.
Still needs real-device testing: pairing with Syzygy, sustained H.264/HEVC streaming, HDR display behavior, controller/mouse capture, Bluetooth audio, sleep/wake, recording playback and cellular/WAN behavior. Microphone/camera/USB forwarding depend on platform and host support and are not promised as Mac-compatible in this test.
Vulkan/libplacebo and FSR are excluded from this first native Metal build; do not enable FSR. QUIC helper dependencies are not bundled in this test; use the standard GameStream transport. Linux-only Gamescope features are not available on macOS. The existing main UI and overlay layout are preserved; this release does not implement a UI redesign.
Report the Mac model, macOS version, host GPU, codec, stream resolution/FPS, connection type and relevant pipeline log when testing. Include build-info.json to identify the exact source.
Eclipse 0.5.7 Development
Eclipse 0.5.7 development build
- WAN / 5G Optimization with negotiated host support and per-feature fallbacks.
- Feedback recovers after temporary network failures with bounded retries.
- Fedora 44 x86_64 RPM, x86_64 Flatpak, and complete source archive.
Install the moonlight-eclipse RPM; debuginfo/debugsource packages are optional.
The RPM includes dependencies for experimental authenticated QUIC. QUIC dependencies are not bundled in Flatpak.
Real cellular streaming performance remains unverified. This is a development preview.
Source: 3f210f9
- Build Fedora RPM: https://github.com/NotADeveloper4665/Eclipse/actions/runs/39075027539
- Build and publish Flatpak: https://github.com/NotADeveloper4665/Eclipse/actions/runs/39075027559
- Source and interaction checks: https://github.com/NotADeveloper4665/Eclipse/actions/runs/39075027555
SHA256SUMS and dev-build.json record integrity and build provenance.
Eclipse 0.5.6 — authenticated QUIC preview
Eclipse 0.5.6 adds experimental authenticated QUIC support for the Fedora RPM.
- Network transport settings: Automatic (prefer QUIC), Force QUIC, and GameStream.
- Pinned host certificate and proof using the paired client key.
- Video/audio QUIC datagrams; reliable setup and control streams.
- Session cleanup and reliable adaptive bitrate updates.
- Six-word Syzygy pairing support.
Fedora 44 x86_64: download the moonlight-eclipse RPM (not debuginfo/debugsource). Its dependency on python3-aioquic is installed by the package manager. Pair first, start Syzygy with -quic, and choose Force QUIC in Streaming settings. Default host QUIC port: UDP 48020.
QUIC is experimental Linux IPv4 support. Real-game streaming and latency remain unverified. The Flatpak bundle is included for existing GameStream functionality; QUIC dependencies are not bundled in Flatpak.
Built from a5f03e9. Fedora RPM, Flatpak and source checks passed.
Eclipse 0.5.3
This release adds a Vulkan presentation option for smoother, lower-latency display on supported client surfaces, and clarifies the settings page.
Mailbox presentation (Fast-Sync): Enable it alongside V-Sync in Basic Settings. When the Vulkan renderer's display surface advertises Mailbox mode, Eclipse displays the newest completed frame at each refresh. Unsupported surfaces fall back to FIFO V-Sync. Gamescope may expose Mailbox mode. The option applies to the next stream and is off by default.
Recording with FSR: The Quick Menu blocks starting a recording when client FSR upscaling is active. Turn FSR off and start a new stream to record incoming encoded video and audio.
Settings organization: FSR and device forwarding remain under Basic Settings, adaptive bitrate is under Streaming, and direct desktop launch is under Host. Explanations for latency, forwarding, recording, and custom resolutions have been updated.
Eclipse 0.5.2
Eclipse 0.5.2
Eclipse 0.5.2 adds finer control over guest input, adaptive bitrate adjustment, and direct desktop launch.
- Guest input permissions: Allow or block keyboard, mouse and touch, and controller input independently. View-only mode disables all three categories for the next stream.
- Dynamic adaptive bitrate: Optionally reduce the stream bitrate when measured network round-trip time or jitter rises, then restore it gradually after the connection stabilizes. Quality, balanced, and low-latency modes tune the response. This requires a Sunshine host that supports runtime bitrate changes; other hosts keep their configured bitrate.
- Launch straight to Desktop: Skip the app selection screen and launch the host app named “Desktop” when available.
Guest permissions are enforced by the Eclipse client and do not change host-side authorization. This release includes the 0.5.1 recording and Flatpak features.
Eclipse 0.5.1
Eclipse 0.5.1 adds in-stream recording and a Flatpak package for cross-distribution Linux installs.
Highlights
- Record H.264, HEVC, or AV1 video with Opus audio directly into Matroska without re-encoding. Start and stop recording from the in-stream menu.
- Install the client as an x86_64 Flatpak across Linux distributions.
- Move FSR scaling and microphone, webcam, and USB forwarding controls under Controls → Basic Settings.
- Carry forward saved stream profiles, adjustable minimum-latency frame pacing, and the compact performance HUD.
Flatpak limitations
The Flatpak sandbox does not expose the host Tailscale CLI/service, USB/IP tools, or privileged pkexec path. Tailscale hosts can still be reached by entering their address manually; Tailscale discovery and host-dependent microphone, webcam, and USB forwarding are unavailable in the Flatpak.
Kyber transport is not included; it requires a compatible host and transport implementation.
Attached assets: Fedora 44 RPM, source archive, and x86_64 Flatpak bundle.
Eclipse 0.05
Eclipse 0.05 reorganizes the Controls settings page so the existing client scaling and device-forwarding options are easier to find.
Changes
- Moved Client FSR scaling under Controls → Basic Settings.
- Moved microphone, webcam, and USB forwarding under Controls → Basic Settings.
- Kept the existing controls and forwarding behavior unchanged.
Not included in this release
Kyber transport and in-stream video/audio recording remain planned work and are not included in 0.05.
Fedora 44 x86_64
The RPM will be attached here after the GitHub Actions build completes. Install it with:
sudo dnf install ./moonlight-eclipse-0.05-1.fc44.x86_64.rpmEclipse 0.04.1
Eclipse 0.04.1 adds client-side FSR scaling, Linux microphone and webcam forwarding, USB/IP passthrough, and expanded stream diagnostics.
Highlights
- Added built-in AMD FSR 1 scaling presets:
- Off
- Quality — 1.5×
- Balanced — 1.7×
- Performance — 2×
- FSR runs through the Vulkan/libplacebo renderer.
- FSR settings are saved globally and per PC.
- Stream diagnostics now show:
- FSR preset
- Vulkan hook status
- Input and output resolution
- Active scaling ratio
- Decoder and rendering statistics
- Added microphone forwarding over authenticated SSH.
- Added webcam forwarding through a Linux virtual camera.
- Added USB/IP passthrough for USB audio, webcams, and other USB devices.
- Added device discovery, unplug detection, SSH failure handling, and device restoration.
- Improved small-window settings layout.
- Restyled the new settings controls to match Moonlight’s existing dark Material theme.
- Added automated QML, UI, FSR, media-forwarding, and USB lifecycle tests.
- Added Fedora RPM dependencies for Vulkan/libplacebo and forwarding tools.
Requirements
- Fedora 44 x86_64 RPM.
- Vulkan-capable client GPU for FSR.
- FSR currently supports SDR 4:2:0 streams.
- Microphone and webcam forwarding require Linux on both client and host.
- USB/IP requires usbip, usbipd, pkexec, SSH keys, and the appropriate Linux USB/IP kernel modules.
- Webcam forwarding requires a writable v4l2loopback device on the host.
Known limitations
- FSR does not provide frame generation.
- HDR and YUV 4:4:4 streams are not currently supported with FSR.
- Native Windows or Shadow PC microphone/webcam receivers are not included yet.
- USB devices are unavailable on the client while they are being forwarded.
- Physical USB hardware transfer and real-world forwarding latency require testing on the target hardware.
Eclipse 0.04
eclipse-0.04 Add Eclipse 0.04 FSR and Linux device forwarding
Eclipse 0.03.9
Eclipse 0.03.9 matches the in-session overlay accent to Moonlight's default dark Material Purple (#CE93D8). It also includes the bitrate slider release fix from 0.03.8.
Install on Fedora 44 x86_64:
sudo dnf install ./moonlight-eclipse-0.03.9-1.fc44.x86_64.rpmThe release includes the RPM and full Eclipse source archive.