Skip to content

MoonlightWeb v0.2.2 — reliable updates, smoother frames

Latest

Choose a tag to compare

@github-actions github-actions released this 29 Jul 16:57

MoonlightWeb v0.2.2 — reliable updates, smoother frames

A release about the two promises v0.2.1 made and did not always keep: the one-click update, and the frames the renderer quietly dropped. MoonlightWeb streams your Sunshine gaming PC to any device with a browser — you still install one app on the gaming PC only; every other device just opens a URL.

Updates

  • The update goes through on a host that runs as a service — the installer used to run inside the server's process tree, so Windows took it down with the service it had just stopped: bar stuck, nothing installed. It now runs outside that tree.
  • A failed update says it failed — the bar could sit at 90% for good while every retry answered "an update is already in progress". The host now gives up out loud, with the reason, and the button works again.
  • The installer is checked before it is run — its exact size and sha256 come from the release itself and are verified against the downloaded file.
  • Closing a failure no longer hides the release — dismissing the error banner marked that version as "don't tell me again". The ✕ now just clears the row.
  • The banner shows up on a page you left open — the host re-checks on its own clock, and the page whenever it comes back to the foreground.
  • The installer keeps a log on the host, next to the server's own, so a failed update can be read afterwards.

Streaming

  • More of the frames that arrive reach the screen — only one draw ran at a time, which capped presentation around 51fps and threw the surplus away. Two now overlap, and that cap was what the micro-stutter on fast motion, and on iOS pinch-zoom, was made of.
  • The image enhancer steps down instead of costing you frames — FSR1 stops fitting inside a 60fps frame once something else wants the GPU. MoonlightWeb walks fsr1 → sgsr → off, never above your setting, and restores it once things calm down; the overlay marks it "(auto)" meanwhile.
  • The latency overlay stays a user tool — the raw pipeline trace that came with the per-leg breakdown is developer output, and is now behind a flag.

Linux

  • Sunshine starts, and is still there after a reboot — the packaged .deb/.rpm ship a systemd user unit, and it is now what we start, and enable. Sunshine used to be reaped along with MoonlightWeb, and never came back after a logout.
  • The distro version you need is written down — below glibc 2.34 the app installs and then refuses to start without a word. Ubuntu 22.04 / Debian 12 / Fedora 36 is the floor, and the troubleshooting page names the one command that shows it.

Installer & setup

  • Sunshine's credentials are prefilled — the wizard showed an empty masked box you had to guess at. A fresh install now arrives filled in and readable; an already-installed Sunshine still starts empty, because those credentials are yours, not ours.
  • The wizard finishes when the address really works — Internet Access was declared done as soon as DNS resolved, which sent you to a domain still on the self-signed fallback. It waits for the certificate too now.

Under the hood

  • New per-pipeline observations — frame arrival interval, encoded frame size, decoder queue depth, submit vs GPU wait — enough to tell "frames cost more" from "the presentation path is back-pressuring the decoder", which is what drives the enhancer decision above.
  • CI no longer runs the whole pipeline on every branch push; tags and pull requests still do, and packaging can be asked for by hand.
  • The website hands Debian-family Linux the .deb instead of the AppImage, and states the same glibc floor as the docs.

Downloads

Install on the gaming PC only:

Platform Asset
Windows x64 MoonlightWeb-installer-0.2.2-win-x64.exe
Windows ARM64 MoonlightWeb-installer-0.2.2-win-arm64.exe
macOS (Apple Silicon) moonlightweb-0.2.2-macos-arm64.pkg
Linux (Debian/Ubuntu/Mint) moonlightweb-0.2.2-linux-x64.deb
Linux (Fedora/RHEL/openSUSE) moonlightweb-0.2.2-linux-x64.rpm
Linux (portable) moonlightweb-0.2.2-linux-x64.AppImage

Playing from a phone, tablet or TV? Nothing to download — just open your server's URL in the browser.

Requirements

  • A gaming PC running Sunshine (the installer can set it up for you).
  • A modern browser on the client device (Chrome/Edge recommended for full codec, HDR and WebGPU support).
  • Linux hosts: glibc 2.34 or newer (Ubuntu 22.04, Debian 12, Fedora 36).