Skip to content

What you need

Moonshine runs on two kinds of computer, and only the show machine has real hardware requirements.

The show machine drives the projectors and does the heavy work: rendering, warping and encoding the live preview.

Everyone else connects with a browser or the desktop app, which almost any current device can run.

The show machine

The show machine needs what TouchDesigner needs, plus enough memory for your media. Derivative publishes TouchDesigner's own requirements on its download page and in its system requirements.

Windows Mac
Operating system Windows 10 or 11, 64-bit macOS 13 (Ventura) or later
Processor A modern multi-core CPU, Intel Core i7/i9 or AMD Ryzen 7/9 class Apple silicon, M1 or newer. Intel Macs aren't supported
Graphics NVIDIA recommended: GeForce GTX 10-series or Quadro/RTX Pascal or newer. AMD Radeon RX 5000 series (RDNA) or newer also works, without the live preview (see below) Built into Apple silicon
Graphics memory 8 GB or more. TouchDesigner's minimum is 4 GB Shared with the system memory
Graphics driver NVIDIA 530 or newer, 581 or newer recommended. For AMD, the latest driver Comes with macOS
Memory 32 GB, or 64 GB for a project with a lot of media 32 GB, or 64 GB for a project with a lot of media
Storage An NVMe SSD The internal SSD
Engine TouchPlayer or TouchDesigner, Commercial or Pro, build 2025.33230 The same
Network Wired Ethernet Wired Ethernet

There's no Linux version.

Graphics

We recommend an NVIDIA graphics card for a Windows show machine. Moonshine runs on any card TouchDesigner supports, and the show plays the same on all of them, but three things work only or best on NVIDIA:

  • The live preview. The show machine encodes the preview picture on the NVIDIA card. With an AMD card there's no live preview: the app and browsers show the scene and every control, but not the live picture, so you align by watching the projection itself.
  • Movie decoding. TouchDesigner decodes H.264 and H.265 movies on an NVIDIA card. Other cards leave it to the CPU, which limits how many large H.264 or H.265 clips play smoothly at once. HAP plays well on any card (see Codecs the show machine plays).
  • NVIDIA-only TouchDesigner features. A component (.tox) you play as a live source can use operators that run only on NVIDIA, such as the Nvidia Background, Flow and Optical Flow TOPs. Derivative lists them under feature-specific requirements.

Intel graphics aren't recommended. TouchDesigner supports only some of its features on Intel GPUs, and Spout, which Moonshine uses for live sources, doesn't work on them.

On a Mac, Apple silicon encodes the preview in hardware. Under heavy load, a Mac drops preview frames to keep the show running, so the preview may stutter while the outputs carry on.

Plan on about four outputs per show machine, and up to eight. Each machine holds the picture only for the outputs it drives, so a bigger show is spread across several machines playing one show together (see More than one show machine).

Show size, per machine (Windows) Suggested
A few surfaces, moderate media NVIDIA RTX card with 8 GB of graphics memory
Many surfaces, large or numerous assets 16 GB of graphics memory or more
Many outputs with heavy compositing NVIDIA RTX 6000 Ada or equivalent

TouchDesigner or TouchPlayer

Moonshine's show server runs on Derivative's engine, a separate product with its own license. This release is tested with build 2025.33230.

  • On Windows, if the machine doesn't have that build, the installer downloads it from Derivative and installs it for you (about 2.9 GB).
  • On a Mac, install it first from derivative.ca. The Moonshine package checks for it and won't install without it.

Use the build each release is tested with. Saving a project in a newer TouchDesigner upgrades the file permanently, and an older build then can't open it.

On a Mac, TouchPlayer is a separate application from TouchDesigner. If both are installed, Moonshine runs on TouchPlayer.

Most show machines need TouchPlayer rather than TouchDesigner. TouchPlayer runs the same project with the same features as the matching TouchDesigner tier. It leaves out the network editor, which a show machine doesn't need, and costs half as much.

What the machine does Buy Price
Runs shows: displays, SDI, NDI TouchPlayer Commercial $300
Locks SDI outputs together with Sync TouchPlayer Pro $800
You also author TouchDesigner projects on it TouchDesigner Commercial $600

These are Derivative's prices at the time of writing. Check their store for current prices. ST 2110 output also needs a Pro license, but this version of Moonshine doesn't produce ST 2110 outputs (see Outputs).

Non-Commercial cannot run a show

The free Non-Commercial license limits every texture to 1280 × 1280, so it can't produce a 1920 × 1080 output, let alone 4K. It also asks for confirmation before it uses cameras, audio devices or the network, and a show machine usually has nobody at it to click. Paid work also requires at least a Commercial license. Use Non-Commercial only to try out the interface.

CPU, memory and storage

  • A modern multi-core CPU: Intel i7/i9 or Ryzen 7/9 class, or any Apple silicon Mac.
  • 32 GB RAM minimum, or 64 GB if the project has a lot of media.
  • An NVMe SSD for the project and its media. Fast sequential reads keep playback smooth.

Projectors

A show can have up to 48 projectors, of any make and model that TouchDesigner can output to, spread across as many show machines as it needs.

For live monitoring of power state, lamp hours and faults, Moonshine uses PJLink. Projectors without PJLink display normally but don't report their status.

Output counts are GPU-bound

How many outputs you can run depends mostly on what the GPU can composite and encode at frame rate. Test on the real hardware before you commit to a number.

Everyone else

Anyone joining the show needs only a browser or the desktop app.

  • The desktop app: Windows 10 or 11, 64-bit, or macOS 13 or later on Apple silicon. See The desktop app.
  • Or a current web browser: Chrome, Edge, Firefox or Safari. The live video preview needs more from the device than the controls do. See will the video preview work here? and joining from another device.
  • Any laptop, tablet or phone from about the last five years. The interface and its 3D view aren't demanding.
  • On a computer, a three-button mouse, or a two-button mouse with a scroll wheel. As in TouchDesigner, the middle button zooms the 3D views and canvases and opens the value ladder on number fields (see Keyboard shortcuts).

One requirement catches people out:

The video preview needs a secure connection

Browsers allow live video decoding only on a secure address. Every control (projectors, warping, masking, playback, the scene) works over a plain http:// address, but the preview picture doesn't appear.

Connect to the show machine over https:// to fix this. The desktop app, for Windows and Mac, shows the preview without any certificate setup. A badge on the preview tells you which case applies.

Network

  • Everyone must be on the same local network as the show machine, or on a routed VLAN that passes WebSocket traffic.
  • Use a wired connection for the show machine. Wi-Fi is fine for everyone else.
  • Keep the show network to people you trust. Any device that reaches the show machine can view its project without signing in. Running or changing the show, including playback, needs an account (see Signing in).
  • Activation needs an internet connection, so a machine that has never been online can't be licensed. After that, shows run without one.
  • A license with no end date checks in with Tridant once a day. Offline, it keeps working for about seven days after its last successful check-in, then stops. Connect the show machine to the internet at least once a week, and always before a long run somewhere without internet.
  • A license with an end date, such as a beta or a trial, stops within a day of that date while the machine is online. Offline, this version may keep running for up to about two weeks past the end date. Don't rely on that, and don't schedule a show for the days after a license ends.

Ports

Port Carries
9980 Control connection and media uploads, plain
9443 The same, over TLS. This is the one that enables the video preview
17351–17392 Live preview video, plain and TLS. Moonshine uses the first free pair at startup
8000 (UDP) OSC from a lighting desk or show-control program, once an administrator turns it on (see Show control)
17420 (UDP) and 17421 (TCP) Traffic between show machines playing one show together: the show's clock, and the leader's media for its followers. The machines find and manage each other on 9980

Every port except OSC and the show clock is TCP. Moonshine uses only these fixed ports, so there's no wider range to open.

The Windows installer opens all of these ports for you. On a Mac, the package lets TouchDesigner accept connections through the macOS firewall. If the venue's firewall is managed separately, allow these inbound connections to the show machine:

  • TCP 9980, 9443 and the range 17351–17392
  • UDP 8000, if you use OSC
  • UDP 17420 and TCP 17421, if several show machines play one show

If you change a port in Moonshine's settings, add a rule for the new port. Most venue and office networks need no changes.

Why the preview uses a range of ports

Another application on the show machine may already be using a preview port. At startup, Moonshine takes the first free pair in the range and tells connected devices which pair it chose. You can't know in advance which pair that will be, so open the whole range.