The desktop app¶
The Moonshine desktop app, for Windows and Mac, is optional, because Moonshine runs in any browser. Its advantage is that it shows the live video preview without any certificate setup.
In a browser, the preview needs an https:// address and a certificate the device trusts (see will the video preview work here?). The app connects directly to the show machine and needs neither. Everything else is the same as in a browser.
Download it from download.moonshine.software.
Installing¶
On a Mac¶
The download is a disk image. Open it, drag Moonshine into Applications, and open the app from there. It needs macOS 13 or later on Apple silicon. The app is signed and notarized by Apple, so macOS asks only once whether to open an app downloaded from the internet. It then asks whether Moonshine may find devices on your local network. Allow it, or the app can't reach the show machine.
The app updates itself as it does on Windows (see Updating Moonshine).
On Windows¶
The download is an installer. Run it and choose whether to install the app for yourself or for everyone who uses the computer, and where to put it. It adds the app to the Start menu. The installed app updates itself when a new version is released.
Windows may warn you the first time
The installer is signed by Tridant, Inc. SmartScreen may still stop a copy downloaded through a browser while a new release earns its reputation. Click More info, then Run anyway. A copy from a USB drive or a network share usually doesn't show the warning.
On Windows and Mac, the first time the app opens, it searches the network for Moonshine.

| Screen | What's happening |
|---|---|
| Looking for Moonshine, with Searching this network for a Moonshine server. | The search is running, and Searching… shows at the bottom right. Servers appear in the list as they answer. Click Enter an IP address to skip the search |
| Found it, with Connecting to and an address | On the app's first run, exactly one show machine answered, and the app connects to it |
| Connect to a server, with One Moonshine server is running on this network. | After the first run, exactly one show machine answered. It's listed with a Connect button, or you can press Enter. The app doesn't connect automatically, in case it isn't the machine you use |
| Connect to a server, with More than one Moonshine server is running on this network. | Click the one you want. Each server is listed by its computer name, such as SHOW-PC, with its address on the right. Point at a long name to read it in full. A show machine on 0.3.16 or earlier appears as Moonshine |
| Connect to a server, with Work on a show from its leader. Its followers are for maintenance. | Some of the machines play one show together. The show's Leader is listed first and outlined: choose it to work on the show. Its followers are indented and dimmed, marked Follower · maintenance. Choose one only to maintain that machine |
| Connect to a server, with an address field | Nothing answered, or you chose to type the address |

Click a server to connect to it. Enter an IP address opens the address field instead. The back arrow beside its title, or Esc, returns to the list.

Type the address of the computer running Moonshine. Any of these work:
| What you type | What it connects to |
|---|---|
192.168.1.50 |
http://192.168.1.50:9980 |
showbox |
http://showbox:9980 |
10.0.0.5:9980 |
That address exactly |
https://showbox:9443 |
That address exactly, over TLS |
If you don't type a port or an https:// address, the app uses port 9980. Click Connect. If what you typed isn't an address, the app shows That doesn't look like an address.
The app remembers the show machine and connects to it directly next time. The Moonshine window reopens where you left it, on the same screen and at the same size. If that screen is no longer connected, it opens on the main screen.
Changing the address¶
If the remembered show machine doesn't answer, because it's off, still starting or has moved, the app keeps trying and shows SHOW-PC isn't responding with the address under the name. If the app hasn't learned the machine's name yet, it shows Your server isn't responding. (The app learns the name the first time it connects.) The app retries every couple of seconds and connects as soon as the show machine answers. Choose another server opens the server list instead, and the server you choose there replaces the remembered one.
To choose a different server while the current one is still working, click the show machine's name in the status bar (Connected to SHOW-PC) and confirm Switch server. Switch server is also in the menu of the server's name at the bottom of the sign-in screen, and beside the server's name and address on the activation screen. The app forgets the address and searches again.
On a follower in a show across several servers, Switch to … leader server on the follower's page goes straight to the leader, and the app remembers the leader from then on. This needs app version 0.3.29 or later; an older app opens its search instead.
An app older than 0.3.20 has neither option. Start it with --forget instead:
On a Mac, in Terminal:
The app forgets the address and searches again. If exactly one show machine answers, it's offered with Connect. The app connects automatically only on its very first run.
Finding the show machine's address¶
The show machine shows its address and a QR code on its own screen (see The show machine's screen). Otherwise, on a Windows show machine, open a terminal and run:
Use the IPv4 Address of the network adapter that's on the same network as you, usually something like 192.168.x.x or 10.x.x.x. On a Mac show machine, System Settings → Network shows the address of each connection.
If it will not connect¶
Check these in order:
Is Moonshine running on the show machine? The app can only connect to a machine that's already serving. Start Moonshine there first.
Are you on the same network? Both machines must be on the same LAN. A guest Wi-Fi network is often isolated from the wired network the show machine is on, even in the same building. This is the most common cause.
Is the address right? Compare it with the address on the show machine's screen. Use Switch server, or start the app with --forget, to search again or type the address.
Is a firewall in the way? The show machine needs inbound TCP on 9980, and on the video range 17351–17392. See what you need.
What the app does differently¶
Apart from showing the preview without certificate setup and finding the show machine for you, nothing. It has the same interface, features and sign-in, and works in the same shared session as everyone in a browser. Links to web pages, such as Buy Moonshine and the documentation, open in your default browser. You can mix freely: some of the crew in the app, others in a browser on phones and tablets, all working on the same show.

On Windows, the window has no separate title bar. Minimize, maximize and close are at the right end of Moonshine's top bar.
The app doesn't hold a license. The show machine is licensed, and its license covers everyone who connects to it (see the FAQ).