Skip to content

Rubylight 4.2.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 15:40

Windows game streaming, written in Rust. Built for Radeon and NVIDIA. Made for Moonlight.

Download Windows x64 installer · Portable ZIP

New in 4.2.0

  • Hardware color conversion. A new AMD AMF setting, Hardware color conversion (amd_vpe, off by default), has the graphics driver's video converter convert and scale YUV 4:2:0 pictures in SDR, HDR10 and HLG instead of Rubylight's shaders. On the RX 7900 XT and the Radeon 780M it gave lower picture quality than the default conversion in every case we measured, and more latency at 1440p 120 fps and in HDR, so it stays off; it remains a setting to compare on your own PC. Full-chroma streams, the pointer drawn by Rubylight, the couch menu and adjusted HDR brightness always use the shaders. A converter failure returns the stream to the shaders with a console warning, and a converter that keeps refusing pictures is left off for the rest of the stream.
  • AMD Direct Capture. A new capture method, AMD Direct Capture (capture = amd), takes each picture the Radeon driver presents on a display connected to the Radeon card, up to the display's refresh rate (at most 200 frames per second). Choose it under Capture; Automatic never picks it. Without a supported Radeon driver the stream falls back to Windows Graphics Capture and the console says why. Frame generation's extra frames are not streamed, with this or any other capture method.
  • Commands for one game in the stream menu. A game's new Stream menu commands panel adds commands that devices with the PC commands permission can run while that game runs, from Nightjar's PC commands, Artemis and the host menu. Each can have an undo, which runs once when the game closes if its command ran. A game can also hide the PC commands from Settings while it runs. The host menu now lists the PC commands too, with a second press to confirm.
  • Stream one app's window instead of a display. Set What to stream to The app's window for an app in Games, for one device in its Per device panel, or for every app under Picture → Capture. The host finds the window among the programs the app started, or by a program name and title you set, and keeps its shape with black bars. Resizing, switching between windowed, borderless and fullscreen, DPI changes and moving the window to another monitor are followed.
  • Input lands on the window. Mouse, touch and pen positions map onto the streamed window, wherever it is on the PC's screen.
  • Minimise and restore. While the window is minimised the stream shows the display and the device says why; restore it on the PC and the stream goes back to the window. A window that is still opening when the stream starts gets a moment to appear, so the stream starts on it. Before the window appears and for 5 seconds after it closes the stream shows the display; When the window closes can end the stream instead.
  • Adapt to network congestion (All settings → Picture → Bitrate and network, off by default). With a client that reports when each video packet arrived, such as Nightjar 5.2.0, the host watches for a queue building on the network: it lowers the bitrate to just under what arrived, paces video at the network's rate and raises the bitrate again when the delay settles. It works together with Lower the bitrate when the link cannot carry it; the lower bitrate wins. The host log shows each change, and the stream timings line and the end of the stream report the queueing delay and the cuts.
  • A device's connect and disconnect commands (Devices, a device, Commands) that the host could not run are now refused when you save them, with the reason, instead of being skipped at every stream. The configuration guide now explains when each kind of command runs: preparation, pause and resume, device connect and disconnect, PC commands, detached commands and webhooks.
  • A switch for stream traffic priority. Network, Streams, Prioritize stream traffic (DSCP), on by default, marks video and audio for devices on the local network as before. Turn it off if sound crackles or the picture stutters with one router: some consumer routers drop or delay marked packets.
  • Compute conversion comes back after a graphics driver reset. After the graphics card reset during a stream, the stream went on converting colour on the graphics queue for the rest of the session, where a busy game can delay frames. The host now waits briefly for a working compute device and goes back to compute conversion, and a reset no longer counts towards turning compute conversion off for the session.
  • On AMD, an encoder that is shut down (at the end of a stream, or when it is rebuilt) first finishes the frames it still had, as AMF expects, for at most 100 ms.
  • Play over the internet without port forwarding. New setting Play over the internet (Settings → Network, off by default): Nightjar devices reach this PC from outside your network over a direct path both sides punch through their routers, also behind carrier-grade NAT. The PC and each paired device find each other on the public BitTorrent DHT with records encrypted with keys only they hold; no server of ours is involved. A device learns the way once while it is on the PC's network. Play over the internet
  • Automatic port forwarding with more routers. The upnp setting, now Automatic port forwarding (off by default), also asks routers through PCP and NAT-PMP, opens the streaming ports in the router's IPv6 firewall through UPnP or PCP, renews the mappings and removes them when the host stops. Stock Moonlight reaches a forwarded port at the PC's public address, which serverinfo now reports as ExternalIP.
  • Internet status in Settings → Network shows what the router mapped, each port it refused and why, the public address, the router type, and a note when the internet provider shares one address among customers (carrier-grade NAT).
  • A warning for unencrypted internet streams. With Internet encryption on its default, When the device supports it, a device outside your network that cannot encrypt still streams, and the console now warns that its stream crosses the internet unencrypted. Required turns such devices away, and its refusal now says how to fix it. Tailscale counts as your local network.
  • Pairing requests from the internet say so. The tray notice and the console's pairing request say when a device asks from outside your network, and ask you to enter its PIN only if you expect it.
  • Lock Windows when the last device leaves. A new setting under This PC, Privacy, off by default, locks the PC 10 seconds after the last device stops streaming, so it is not left signed in. It never locks during a stream, waits for a device that moves the stream or reconnects, and the next stream unlocks the PC from the lock screen.
  • Play together from your own devices. Turn it on with When another device joins the running game (Settings → Games → Play together, off by default): with Ask the player or Let in without asking, a second paired device that joins the game another device plays becomes its guest, with the same picture and sound on its own stream. Nightjar's Join and a Moonlight client starting the running app both work. While it is off, your own devices join or resume the running game without asking, as before.
  • You decide who joins. With Ask the player the player lets each guest in, from Nightjar or the console's Home, within 45 seconds. What a guest may do sets View only, Controller (the default: its own controller as the next player) or Controller, keyboard and mouse. A view-only guest gets no controller, keyboard, mouse or clipboard on the PC. The player can change a guest's permission during the game, kick it, block it for the rest of the game, or let it in for an hour or a day.
  • One keyboard and mouse at a time. A guest with keyboard and mouse takes them when nobody else used them for two seconds; the player, or someone at the PC using its own mouse or keyboard, takes them back at once.
  • The player's own stream is unchanged: each guest gets its own encoder on the same capture, at its own size, codec and bitrate.
  • RTX HDR and RTX Video enhancement on GeForce RTX. Where a release lists it, a separate NVIDIA download, rubylight-nvidia-setup-<version>.exe, adds two image enhancements that run on the PC's graphics card before encoding; the regular installer does not include them. RTX HDR turns an SDR game into HDR for a device that streams in HDR, while the PC's display stays in SDR. RTX Video enhancement cleans up and sharpens the picture at the stream's own size, with a strength from 0 to 100. Both are off until an app or the host turns them on; each app has its own switches and values on its page in Games, and Nightjar can turn either on or off for one PC. The NVIDIA download is not code-signed, and it updates only to the next NVIDIA build.
  • Full chroma for Nightjar is on by default. Nightjar's Sharper colored text now works without a second switch on the PC. The host only offers full chroma; a stream uses it only when its device asks, so other devices and stock Moonlight are unaffected. A PC where you turned it off keeps it off.
  • Hardware metrics are on by default. A paired device's overlay can show the PC's CPU and GPU readings during its stream. The host reads them only while a device asks for them. A PC where you turned it off keeps it off.
  • Back up and restore settings. Advanced, Troubleshoot, Settings backup saves the settings, apps, covers, each device's own settings, game settings files and webhooks as one file, and restores such a file on this PC or another one. The tray's Back up settings saves one to Documents\Rubylight, and Restore settings opens the panel.
  • Secrets only when you choose. Include pairing identity and sign-in adds this PC's pairing certificate, the paired devices, the console sign-in, API tokens and webhook secrets, with a warning that anyone with the file can use them. Without it, a restore keeps this PC's own.
  • A restore you can check. The host checks the file first and lists what changes, saves the current settings as a backup of its own, then restarts and applies it. A failed restore keeps the previous settings and says why in the console.
  • Switch 2 Pro Controller. With usbip-win2 installed, a Nightjar client's Switch 2 Pro Controller appears on the PC as a Switch 2 Pro Controller, the same USB device a real one is: the C button, both grip buttons, both sticks, gyro and accelerometer, battery and rumble. Other controllers keep their pad. Switch 2 Pro (USB/IP) under Controller type gives every controller one. Without usbip-win2 the controller arrives as a Switch Pro and the console says why.
  • Motion server for emulators (off by default). Turn on Motion server for emulators (DSU) under Controllers, and Cemu, Dolphin, Citra and other emulators read each streamed controller's gyroscope, accelerometer, buttons and touch from UDP port 26760. It listens on every network interface without a password; the Windows Firewall keeps other devices out unless you allow the port.
  • A mouse games read like a real one. With the optional USB audio and haptics driver installed, the PC's mouse is a virtual USB mouse polled every millisecond, with fine wheel steps and horizontal scroll, instead of Windows input injection, which some games and anti-cheat ignore. All settings › Sound & controls › Mouse input method (mouse_mode): Automatic (the default: the virtual mouse when the driver is installed), Virtual mouse or Injection, also per game and per device. Without the driver, mouse input is injected as before, and the stream says why when Virtual mouse was chosen. Measured on the RX 7900 XT from a move reaching the host to the game's input: about 0.25 ms at the median for the virtual mouse against 0.19 ms for injection, and about the same at p95.
  • Touchpad gestures from devices. A tablet's keyboard-cover touchpad or a laptop's touchpad in Nightjar reaches Windows as a precision touchpad, so two-finger scroll, three- and four-finger gestures and Windows' touchpad settings work (native_touchpad, on by default, with the same driver).
  • input_latency_probe shows whether a game sees the mouse as injected and how long a move takes to reach it (Virtual mouse and touchpad).
  • Settings say what they cost. The console's settings, app options and device options now say what a change gives you, what it costs (delay, picture quality, network use or load on the PC) and when to change it, so a setting you don't know tells you whether to leave it alone. Technical terms such as VRR, HDR and bitrate stay, lesser-known ones are explained in a few words, and the full technical detail remains under "More". No setting, value or default changed.
  • Several texts that described a setting wrongly are corrected, among them the Playnite sync, USB forwarding, play over the internet, the encryption modes and the AMD low-latency mode.

Tested. On the RX 7900 XT, window capture started on the app's window in 40 of 40 streams (30 resumed, 10 on a fresh host) with one encoder each, and 200 minimise and restore actions over 5 streams switched between the window and the display in place, with no frame gap over 35 ms and no graphics driver reset. Play together ran with a Retroid Pocket 6 as the player and a Windows laptop, a Linux PC and stock Moonlight as guests: ask, let in, deny, no answer, view only, controller, kick, block and the console's approve; with a guest on the same Wi-Fi the player's end-to-end latency rose by 0.3 ms at p95. A Windows laptop streamed alone at 1080p60 in HEVC (59.8 fps) and AV1 (60.0 fps). The virtual mouse was checked with a scripted Nightjar client: fine horizontal scroll, the top left corner, two-finger scroll on the touchpad, and its first moves after it is plugged in reaching raw input 4.6 to 4.8 ms after they arrive; from a move reaching the host to raw input, 0.25 ms at the median against 0.19 ms with injection, and level at p95. A Switch 2 Pro Controller reached the PC with all 21 buttons, both sticks, motion and rumble, and the motion server sent 202 packets a second to a DSU client. Adapt to network congestion was compared on the Retroid over three pairs of 40-second runs with 930 Mb/s of other traffic on the same access point: no worse on any figure, with gains inside the run-to-run spread, so it stays off. Play over the internet found the PC's public address through this router, published its record and was found by a device-side client; automatic port forwarding created its router mappings and removed them when the host stopped. AMD Direct Capture started on the RX 7900 XT, and Hardware color conversion was compared with the default conversion on the RX 7900 XT and the Radeon 780M. RTX HDR and RTX Video enhancement were built and unit-tested. The host's 5,392 tests, Nightjar's protocol and desktop tests on Windows (3,258) and Linux (2,746), the console's 462 checks and the release tools' tests pass.

Install or upgrade

Disconnect your stream and close host-launched games, then run the installer. Your settings, paired devices and game library are preserved. Open the console at https://localhost:47990.

Full release notes · Build and tests · Code signing policy · Host validation