Skip to content

Sound

The show machine has one audio output, shared by the whole show. This page covers choosing the output device, setting each clip's level, reading the meters, and which outputs carry sound.

Everything Moonshine plays is mixed into one master bus: both clips during a crossfade, whichever cuelist is running, on every surface. The master bus goes to the show machine's audio device and is also embedded in every output that's a video stream. There's no per-projector volume and no second soundtrack.

Settings → Project → Audio: Driver, Device, Buffer, Master volume and the Master, Deck A and Deck B level meters

Sound comes out of the show machine, not out of your browser

The live picture in your browser has no audio, on any device. Listen at the show machine, or on whatever receives your NDI or SDI feed.

The exception is the preview player on the Assets tab, which plays the file itself through your own speakers. It tells you whether the clip has an audio track, but not what the show is playing.

Choose the output device

Open Settings → Project → Audio.

These settings belong to the project. Each project keeps its own device and levels, and the show machine switches to them when the project opens. A new project starts with the settings of the project that was open.

Opening the project's settings claims them

Opening any page of Settings → Project takes the project's settings lock, and leaving the page releases it. While another operator has one open, the controls in this section are dimmed and read-only for you. See Locks.

Driver

The list always has the same two drivers, in this order:

Driver What it is
DirectSound / CoreAudio The standard driver every machine has, and the default: DirectSound on a Windows show machine, CoreAudio on a Mac.
ASIO The low-latency driver some audio interfaces ship with.

A driver this machine can't use stays in the list, grayed out. Hover it to see why.

Changing the driver clears the device, because each device name belongs to one driver. Choose the driver first, then the device.

An ASIO device belongs to one application at a time

ASIO takes the audio interface exclusively. If another application on the show machine is using the interface, Moonshine can't open it, and the other way around.

Device

The list shows exactly the devices the show machine reports, so there's nothing to type. If a device isn't in the list, the machine doesn't see it.

  • Until you choose a device, the box reads No output — silent. The machine's own speakers stay off, and a note says so. Stream outputs still carry audio: see Which outputs carry sound.
  • If the machine no longer reports a saved device, it stays selected and is marked (missing), with a warning below. Moonshine doesn't switch to another device by itself, so a re-cabled or replaced machine can't send the show to the wrong output without telling you.

Re-scan after you plug something in

After you connect a USB interface or a new card, press Re-scan devices to update the list without a restart. You can scan once every ten seconds; pressing it sooner shows the list you already have. If a device you just connected isn't there, wait ten seconds and press it again.

Buffer

The buffer is how much audio the machine queues ahead of the sound card.

Setting Use it when
5 ms — lowest latency Lip sync matters most and the machine isn't busy.
10 ms
20 ms — default You're starting out.
50 ms
100 ms — safest The machine is rendering hard and you hear crackles.

The sound is delayed by the buffer. A shorter buffer keeps sound tighter to the picture but risks dropouts when the machine is busy; a longer one handles a heavier show at the cost of a few milliseconds of delay. Start at 20 ms and change it only if you hear a problem.

A free Non-Commercial TouchDesigner license blocks this

With a Non-Commercial license, TouchDesigner asks for confirmation before it uses an audio device, and the dialog opens on the show machine's desktop. Until someone clicks it there, the device never opens and the show is silent. See What you need.

Master volume

One level, 0–100%, for everything the machine plays. It's applied to the master bus before the bus splits to the device and the streams.

Master volume changes what your streams carry

The same level feeds the speakers and the audio embedded in every NDI and SDI output. Turning it down to work quietly in the room also turns down what a receiver downstream is recording. To listen quietly, use the machine's own volume control, the mixer or the amp instead.

The bus is limited at full scale, so a hot mix can't overdrive an embedded stream. That isn't headroom: if the master meter sits at the top, bring down the levels feeding it.

Reading the meters

Three meters sit under the master volume: Master, Deck A and Deck B. Moonshine plays a cuelist through two decks so one clip can fade into the next, and Deck A and Deck B are those two. During a crossfade, both move.

The meters update once a second, with no smoothing between readings. Each one shows the average level of its loudest channel, so a stereo pair with one dead side still reads high instead of reading at half. A bar turns red at 95% of full scale.

No meters is not the same as no sound

The meters appear only while an audio device is open. With no device chosen, the panel reads Levels appear once an output device is playing, but your NDI and SDI outputs are still carrying audio.

The deck meters read the signal before the master volume, and the Master meter reads it after. Together they help you find a problem:

What you see What it means
A deck meter moves, Master doesn't Master volume is at 0.
Nothing moves, and the panel says levels will appear later No device is open. Choose one under Device.
The meters move, but the room is silent The signal is leaving Moonshine. The problem is further down the chain: the wrong device, a muted mixer channel or an amp.
A warning under the meters The machine reported a fault, shown in the machine's own words.

Set the volume of a clip

Every cuelist row has a speaker button and a Volume box, between the length box and the ⋮ menu. A cue's properties in the scene graph have the same pair.

A cue row: its transition chip, number and thumbnail, the length box in seconds, the speaker button and the volume box in percent

Control Behavior
Speaker button Mutes the clip. The icon turns red while it's muted.
Volume box 0–100%, in steps of 5. Disabled while the clip is muted.

Muting keeps the volume setting, so unmuting brings back the level you set rather than jumping to full.

Both take effect immediately on a clip that's already playing; you don't need to trigger it again. Both are saved with the project and shared with everyone on the show, like the rest of the cuelist. A clip plays at 100% until you set its volume.

Each clip keeps its own volume all the way through a transition, so a quiet clip fading in doesn't lower the clip it's replacing.

Sound across a transition

Audio crossfades on the same clock as the picture. The outgoing clip fades down while the incoming one fades up, over exactly the transition's duration: a Dissolve · 0.6s is a 0.6-second audio crossfade, and a Cut (0 s) is an instant switch. There's nothing to set.

The crossfade is equal power: the two levels are shaped so their combined loudness stays even through the middle, where a linear fade would dip.

See Transitions to choose the transition's shape and duration.

What actually has sound

Source Audio
Video file Its own audio track. A file with no audio track plays silent.
Still image None.
NDI source The sender's audio.
TouchDesigner component (.tox) Only if the component has an Out CHOP other than one named control; that's its sound. Without one, it plays silent.
Spout source None. Spout, and Syphon on a Mac, share picture only.
Web page None. A web page plays picture only.
Video device None. A camera or capture card plays picture only.

Everything is resampled to 48 kHz

Moonshine plays all audio at 48 kHz, the rate SDI and ST 2110 use. A file at another rate, such as 44.1 kHz, is converted and plays at its normal pitch and speed.

Which outputs carry sound

Output type Sound
The machine's audio device Always: the master bus, on the device you chose above.
NDI output Yes, embedded in the stream.
SDI output Yes, embedded in the stream.
Display output No. For local sound, use the machine's audio device.

Stream outputs have an Audio switch at the bottom of the output card. It's on by default. Switch it off on any output that should carry picture only.

The output card of an NDI output, with the Enabled switch at the top and the Audio switch at the bottom

A Display output has no Audio switch, since there's no stream to carry the sound.

Embedded audio does not need anyone logged in

Stream outputs carry sound whether or not a browser is connected, so a show machine running on its own still puts sound on its NDI and SDI feeds.

When there is nothing to hear

Work through this list. The most common causes come first.

  1. Is the clip muted, or at 0%? Check the speaker icon on the cuelist row: red means muted.
  2. Does the clip have sound at all? Preview it on the Assets tab and listen. A file with no audio track, a still image, a Spout source, a web page and a video device are all silent.
  3. Are the meters moving? Open Settings → Project → Audio.
    • If a deck meter moves but Master doesn't, master volume is at 0.
    • If nothing moves and the panel reads Levels appear once an output device is playing, no device is open. Go to step 4.
  4. Is a device chosen? No output — silent in the Device box means the machine's own speakers are off. Choose a device.
  5. Does the device say (missing)? The machine no longer reports it. Choose a device that's in the list, then check the cabling on the one that disappeared.
  6. Did you just plug something in? Press Re-scan devices. It spins while the machine looks, then says how many devices it found. If yours isn't there, wait ten seconds and press it again.
  7. For a stream: is the output's Audio switch on? An output can carry a perfect picture with its audio switched off.
  8. Check past Moonshine. If the meters move and a device is open, the signal is leaving the machine. Check the machine's own volume control, which output the cable is plugged into, and the mixer or amp at the other end.
  9. Check the show machine's screen. Its status panel has an Audio: line that names the open device, or reads no output device with the reason. It's the quickest way to see whether the machine is trying to play sound, without a browser.
  10. Check the TouchDesigner license. With a Non-Commercial license, a confirmation dialog may be waiting on the show machine's desktop, stopping the audio device from opening.

Remember that your browser doesn't play the show's sound: the live picture has no audio.

Where to go next