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.

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.

| 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.

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.
- Is the clip muted, or at 0%? Check the speaker icon on the cuelist row: red means muted.
- 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.
- 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.
- Is a device chosen? No output — silent in the Device box means the machine's own speakers are off. Choose a device.
- 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.
- 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.
- For a stream: is the output's Audio switch on? An output can carry a perfect picture with its audio switched off.
- 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.
- 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. - 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¶
- Transport controls: start a cuelist, and wire it to a surface first
- Transitions: the transition's duration is also the audio crossfade's duration
- Outputs: where a projector's picture goes
- Troubleshooting: other problems on site