Will the video preview work here?¶
Every part of Moonshine except the live video preview works in any modern browser, over any connection. The preview has two requirements. When one is missing, a badge on the preview tells you which, and this page explains how to fix it.
This page covers the live preview only. Which video files play on the projectors is a separate question, answered in Codecs the show machine plays, and what your device can decode doesn't affect it.
The two things the preview needs¶
A secure connection. Browsers allow live video decoding only on a secure address: https://, or localhost on the show machine itself. Over a plain http:// address to another machine, the browser doesn't offer the decoder at all. This is a browser rule, so no Moonshine setting can change it.
A device that can decode HEVC. The show machine sends the preview as HEVC (H.265), whatever the codec of the media it's playing, and your device has to decode it. Most current hardware can, but not all.
What the badge is telling you¶
| Badge | What it means | Fix |
|---|---|---|
| Live preview unavailable — use localhost or https | You reached the show machine at a plain http:// address, so the browser doesn't offer the video decoder. |
Use the https:// address instead (see joining from another device), or use the desktop app for Windows or Mac, which needs no certificate setup. |
| Live preview unavailable — this device doesn't trust the show machine yet | You're on https://, but this device hasn't been set up to trust the show machine's certificate. |
Click Fix → on the badge, or open /trust.html on the show machine's address, and follow the steps. You do this once per device. |
| Live preview unavailable — import the Moonshine certificate into Firefox | As above, but Firefox keeps its own certificate store, so it needs the certificate imported. | Import the certificate into Firefox's own store. Clicking through the warning isn't enough. |
| Live preview unavailable — this browser can't decode it | The connection is fine, but this device can't decode HEVC. | See Which devices can decode HEVC. Use a different device, or work without the preview. |
| Hardware video decoding is off — restart Moonshine | In the desktop app: the graphics hardware had a fault, and hardware video decoding stays off until the app restarts. | Quit Moonshine and open it again. |
| Live (a small, dim green dot) | The preview is live. It shows the show as the show machine draws it, not any one projector's output, so a test pattern on one projector, or what another machine outputs, doesn't appear in it. Hover over it to see how long ago the last new picture arrived. | Nothing to do. |
| Live preview paused — no new picture | The connection is open, but no new picture has arrived for a few seconds. Moonshine reconnects by itself after 8 seconds. | Wait. If it keeps coming back, check that the show machine is still running. |
| Loading live preview… | The preview is starting. | Wait a moment. |
| Reconnecting live preview… | The preview dropped, and Moonshine is reconnecting it. | Wait. If it lasts, check that the show machine is still running. |
| Live preview unavailable — retrying in 30s | Several attempts in a row failed, and Moonshine is waiting before it tries again. | Wait, or click Retry on the badge to try now. |
The app avoids the first three
The desktop app, for Windows and Mac, connects without certificates, so the secure-connection and certificate badges don't appear there. It's the quickest way to a working preview on a computer.
Which devices can decode HEVC¶
Moonshine asks your browser whether the device can decode the preview, so the badge reflects your actual hardware rather than a guess based on the browser. As a rough guide:
| Device | Preview |
|---|---|
| Windows on recent Intel, AMD or NVIDIA graphics | Yes |
| Mac with Apple silicon (M1 and later) | Yes |
| Recent Intel Macs | Usually |
| iPhone / iPad, iOS 17 or later | Yes |
| Android: recent devices, Chrome | Usually |
| Older phones, tablets and laptops | Often not |
| Virtual machines and remote desktops | Often not: they usually have no hardware decoder to offer |
HEVC decoding depends on the hardware. A device either has the decoder or it doesn't, and no browser setting adds one. If a device reports that it can't decode HEVC, that's accurate for that device.
A device that cannot show the preview is still fully usable
It can control every part of the show; only the live picture is missing. On a mixed crew, it's normal for some devices to show the preview and others not.
If you are choosing hardware¶
For a reliable preview, use a recent laptop, phone or tablet on the show machine's https:// address, or the desktop app on Windows or a Mac to skip certificates entirely.
Don't rely on a virtual machine or a remote-desktop session for the preview. They rarely offer a hardware decoder, and nothing else can stand in for one.
See What you need for the show machine's own requirements, which are much stricter.