Skip to content

PyroWave is an experimental video codec for a wired gigabit local network. Of the published clients, the separate Nova Beta app for Android can play it, and so can Nova 1.5.0 for Linux and Steam Deck, which is in Beta, subject to its device check; stable Nova for Android doesn’t offer it. Nova is the client built alongside Polaris. Moonlight cannot play it on any platform, and no iPhone, iPad, Mac or Windows client can: if you stream from one of those, nothing changes and there is nothing to turn on. Every frame is a key frame, so the client decodes each one much faster than H.264, HEVC or AV1, and the stream needs much more bandwidth for the same picture. Details are in the PyroWave reference.

It suits you if fast decoding, or sharp text on a streamed desktop (Nova for Android streams it in 4:4:4), matters more to you than bandwidth. It does not work in a Space, which exists only if you set one up. You will need:

  • Polaris 1.4.13 or a later release on a Linux host, such as 1.5.0, not a 1.4.13 beta. A host that installed a 1.4.13 beta by hand gets the release with an ordinary update to 1.5.0 (why it matters).
  • The Nova Beta app for Android, 1.4.13-beta.3 or newer, on the phone or handheld, which installs beside stable Nova (below). So: the Polaris release on the host, Nova Beta on the client.
  • Or, on Linux or a Steam Deck, Nova 1.5.0’s standard bundle, which includes PyroWave and checks the device before launch. The separate 1.4.13 PyroWave Alpha is an older package (version-specific steps). Vulkan version alone is not proof that a device can decode a chosen stream size.
  • Wired gigabit ethernet on every link, the client’s included, usually through a USB ethernet adapter or dock (below). Nothing blocks Wi-Fi, but it usually stutters.
  • Vulkan 1.3 on the host’s GPU and on the client’s. You can check the host first; the phone has no check to run first (why).

Caution, KDE host with a display in HDR: if capture goes through kms, PyroWave cannot stream at all, SDR included. Capture can go through kms when Force a Specific Capture Method (capture, Settings > Advanced in the web console) is KMS, or, on Autodetect, when the optional polaris-kms add-on is installed and enabled; most hosts have neither. If yours does, turn HDR off on every display before each PyroWave stream, or keep HEVC or AV1 for HDR; PyroWave on a KDE desktop is SDR either way (how to check, and other routes such as Private Stream).

Install the Nova Beta app, 1.4.13-beta.3 or newer, from Nova’s releases, where betas are marked Pre-release. For almost any current phone or handheld, take Nova-Beta-Android-arm64-v8a.apk (other devices). Stable Nova, 1.5.0 included, cannot select PyroWave on Android: its release builds leave the codec out.

Nova Beta installs beside stable Nova as a separate app, Nova Beta on the home screen (Nova Pre in early betas), with its own settings and host list. Pair your host in Nova Beta (Pair and manage devices) before you stream; stable Nova keeps its own pairing.

Install the latest Polaris release with the update guide or the package repositories, which never serve a beta. Every release package contains the encoder: Fedora 44 and 45, Arch, Ubuntu 24.04, and SteamOS 3.8 and 3.9, with Bazzite 44 taking the Fedora 44 RPM. The Fedora 45 and SteamOS 3.9 packages start with 1.5.0. Polaris 1.4.12 and older, and Windows and macOS hosts, have none.

If you ever installed a Polaris 1.4.13 beta by hand and never updated past it, update to the latest release: 1.5.0 is a newer version, so an ordinary update replaces the beta. Beta.1 has no encoder; beta.2 and beta.3 have it but can crash as a stream starts (more).

Every link should be gigabit: the host’s port, any switch, and the client’s USB ethernet adapter or dock. Many cheap USB adapters are 100 Mbps, which leaves no headroom even at 1920x1080 at 60 fps, so pick one sold as gigabit (1000 Mbps). Turn Wi-Fi off on the client while you stream; if Nova still reaches the host, the adapter is carrying the stream.

You choose PyroWave in Nova, not on the host: the Polaris web console has no PyroWave setting. Nova for Linux has its own steps.

In the current Nova Beta app, PyroWave is under Video Codec in Play Setup, and Nova recommends a bitrate from the host’s advice for the selected size, frame rate and colour format; Nova’s PyroWave on Android guide has its steps, and the bitrate advice here has the figures. The steps below were written for Nova Beta 1.4.13-beta.3, and their flat figures predate the calibrated advice.

  1. Open Nova Beta, not stable Nova, then Settings > Client Stream Defaults. Steps 2 to 5 are on that screen.
  2. If you use a Quality Preset (the first item), pick it first: it sets resolution, bitrate and codec together.
  3. Set Video resolution and Video frame rate, then raise Video bitrate to Nova’s advice: about 91 Mbps for 1920x1080 at 60 fps, 114 Mbps for 2400x1080 at 60 fps, 162 Mbps for 2560x1440 at 60 fps and 182 Mbps for 1920x1080 at 120 fps (other modes). Pick the figure for the resolution you set here, not the host’s screen. The slider stops at 300 Mbps, below the advice for 2560x1440 at 120 fps (about 323), and Nova does not raise the bitrate for you.
  4. Open Change codec settings and choose PyroWave (experimental).
  5. Leave Request HDR when host supports it off. HDR on PyroWave has not been shown end to end.
  6. Start a stream that is not a Space.

The codec applies to every host in Nova Beta. While PyroWave is chosen, a stream to a Space, or to a host that does not offer PyroWave, is refused, so choose another codec before you stream one. Auto never picks PyroWave.

  • In Nova for Android, turn on Nova Stream HUD under Settings > Overlays & Controls (off by default). During the stream it shows the codec as PYRO.
  • In Polaris, Mission Control in the web console names the codec of the running stream.

Nova never falls back from PyroWave to another codec: a stream started with PyroWave chosen is PyroWave.

Capture path. Doctor shows whether frames reached the encoder on the GPU or in host memory; either works (what each frame costs). On Polaris 1.4.13, its “CPU color conversion” label shows for every PyroWave stream; ignore it. Newer builds say where the encoder converted colour.

Bitrate. Plan the link for the full bitrate you set. Polaris 1.5.0 and newer quote PyroWave’s own figure, from its author’s quality model, with the target for a phone’s or handheld’s own screen set by a check on a Retroid Pocket 6. On such a screen, set about 101 Mbps for 1920x1080 at 60 fps in 4:2:0, 109 Mbps in 4:4:4, which Nova for Android streams, and 215 Mbps at 120 fps in 4:4:4, at the host’s default 10% FEC with stereo audio. The exact 1080p120 4:4:4 request is 214.898 Mbps, which leaves 192.396 Mbps for video; Nova 1.5.0 reads the host advice first and uses the same 31 dB model when it needs a fallback. Auto and Use recommended stay at or below 300 Mbps. A number entered by hand can reach 500 Mbps only when the host advertises that limit; older hosts without it keep 300 Mbps (other figures, and their limits). When a stream sits more than a tenth below that on a clean network, Doctor offers one tap to raise it, to at most 300 Mbps, with Undo. Where 300 Mbps or your max_bitrate is less than the model asks, as at 3840x2160 and 120 fps in 4:4:4, and most frames still fill the codec’s byte budget, Doctor suggests a lower resolution or frame rate, or HEVC, instead. Live Tuning raises a stream above your setting only to its 2 Mbps floor, and stops cutting at half the advice.

Symptom Cause Fix
No PyroWave in the codec list. You opened stable Nova, or an older Nova beta. Open the Nova Beta app, 1.4.13-beta.3 or newer (Nova for Android).
No codec choice in Play Setup. Nova for Android 1.4.13-beta.3’s Play Setup has none. Use Settings > Client Stream Defaults > Change codec settings.
Nova for Linux: no PyroWave in Video Codec, or Play Setup says it cannot start. Nova 1.5.0’s standard bundle includes the decoder; older 1.4.13 packages differ. The device may still lack the required profile or decoder features. Check your package version and Play Setup’s message; the 1.4.13 instructions describe the separate historical Alpha.
Nova says “This host does not offer the PyroWave profile this build of Nova can decode.” The host runs Polaris older than 1.4.13, 1.4.13-beta.1 or a build without the encoder, or its GPU lacks what the encoder needs. Or the stream is a Space. Update to the latest release (over a beta), then check the host’s GPU. For a Space, choose another codec.
Nova says “Failed to start video stream establishment (error -2)” or “Video decoder failed to initialize…”. The phone’s decoder could not start at this size, or the phone cannot decode PyroWave. Lower the resolution; otherwise choose another codec (the phone’s GPU).
No picture ever, and systemctl --user status polaris on the host shows Polaris failed or restarted. A Polaris 1.4.13-beta.2 or beta.3 package, whose Vulkan video encoder crashes as a stream starts. Update to the latest release.
KDE host with a display in HDR: the host refuses the stream with a message naming HDR, or RTSP error 503, SDR too. On Polaris 1.4.13, Nova connects, shows no picture, then the stream ends. Capture goes through kms, and KWin’s HDR frames come in a format PyroWave cannot read. Turn HDR off on the host display, or use HEVC or AV1 (other fixes).
Refused with Request HDR when host supports it on. The host refuses PyroWave HDR unless the captured display is in HDR, and it has not been shown end to end. Turn Request HDR when host supports it off.
Soft picture, and Nova says “PyroWave asks for about N Mbps at this resolution and frame rate.” The bitrate is too low, often from a Quality Preset (10, 20 or 50 Mbps). Raise Video bitrate, or lower the resolution or frame rate.
Stutter or dropped frames. The link cannot carry the bitrate: Wi-Fi, or a 100 Mbps adapter or port. Wired gigabit on every link, Wi-Fi off on the client, or a lower mode and bitrate (why).
A stream used another codec after you chose PyroWave. A Quality Preset picked afterwards set the codec. Set Video bitrate and choose PyroWave again.