Skip to content

Live sources

A live source is a picture that comes from somewhere other than a movie or still: a camera, another application, a web page or a piece of TouchDesigner. Moonshine supports five kinds, and they sit in the media library beside your clips and images.

The Assets tab filtered to Sources: an NDI source with its NDI · machine (channel) line and a Spout source

The five kinds

Kind What it is Where it comes from
NDI Video carried over the network, between machines Any machine or application on the same network that is sending NDI
Video device Video on a cable into the show machine: a webcam or USB camera, or SDI or HDMI through a capture card A device plugged into the show machine itself
Spout Video passed directly between two applications on one machine, through the graphics card: Spout on Windows, Syphon on a Mac An application running on the show machine itself
Web page A page drawn live by a browser on the show machine An address, https://…, that the show machine can reach
TouchDesigner Component A .tox: a piece of TouchDesigner that renders live A file you upload, like a clip

NDI works across machines. A playback server in the rack, a camera encoder or a media server in another room can all be sources, as long as they send NDI on the same network. A firewall, a VLAN or a different subnet can hide a sender that's working. To reach a sender on another subnet, give the show machine its address: see Senders on another subnet.

A video device is a cable into the show machine: a webcam or USB camera, an HDMI capture dongle, or an SDI or HDMI signal on a Blackmagic, AJA, BlueFish444, Deltacast or Datapath capture card. On a Mac, Blackmagic and AJA cards and the Mac's own cameras are supported. Install the card's driver on the show machine.

Spout stays on the show machine. The sending application has to run on the show machine, so your laptop can't send Spout to it. With no network and no encoding, latency is minimal. On a Mac the same source receives a Syphon sender instead. Settings calls it Spout / Syphon, and the media library calls it Spout on both platforms.

The show machine opens a web page itself, so it needs to reach the page: internet access for a page online, or a route to the machine for a page in the venue. A page your laptop can open may still be out of the show machine's reach. See Web pages.

A component runs on the show machine. See A component is code.

Adding one

You add an NDI, video device or Spout source in two steps. First, name the senders and devices the project receives in Settings → Project → Video. These are the project's video inputs. Then, on the Assets tab, Add Source lists those inputs, and the one you pick joins the library. You add a web page from the same menu by its address. A component is a file, so you upload it.

  1. Open Settings → Project → Video. Under On the network, the NDI card lists the NDI senders the show machine can hear that aren't inputs yet.
  2. Click Add beside the one you want. It becomes an input, named as it is on the network. Change its Name if you want to call it something else.
  3. On the Assets tab, click Add Source, beside Upload, and click the input under NDI.

The source appears in the library, for you and for everyone else on the show.

To add a sender the show machine can't hear yet, type its name under Add by name and press Add.

If the last scan didn't hear an input, its card says Not seen in the last scan. Check that the sender is running, then press Re-scan.

  1. Open Settings → Project → Video. Under On the show machine, the Video Device card lists the devices on the show machine that aren't inputs yet, each with its driver, for example DeckLink Duo (1) · Blackmagic.
  2. Click Add beside the one you want. It becomes an input, named as its driver names it. Change its Name to call it something else, such as Stage camera.
  3. On the Assets tab, click Add Source and click the input under Video Device.

To add a device that isn't plugged in yet, type its name under Add by name, exactly as its driver will name it. The show machine finds it when it plays.

If nothing is found, the card lists the drivers it checked: No video device was found. Checked: Blackmagic, AJA, …. Install the card's driver or plug the camera in, then press Re-scan.

  1. Open Settings → Project → Video. In the Spout / Syphon card, under Add a sender, type the sender's name exactly as the sending application shows it, and press Add.
  2. On the Assets tab, click Add Source and click the input under Spout / Syphon.

The card doesn't list Spout senders, so you always add them by name. It says:

This build does not list Spout senders. Add a Spout source by typing its sender name.

  1. On the Assets tab, click Add Source and click Web page….
  2. Type the page's full address, starting with https:// (or http://), and press Add.

The page joins the library named after its site (https://clock.example.com/face becomes clock.example.com), and you can rename it like any item.

If the address isn't complete, it isn't added, and a message under the field says why: Type the whole address, starting with https://, An address has no spaces., or Up to 2048 characters.

A .tox is a file, so you upload it like any other: drag it onto the drop zone in the properties column, or use Upload.

Only an administrator can add one. An operator's file picker doesn't offer .tox files, and the drop zone explains:

Only an admin can add or replace a component (.tox): a component is code, and it runs on the show machine.

The item is named after the file without its extension, so particles.tox becomes particles.

Settings → Project → Video: the Status panel, Canvas, Frame rate, Spout / Syphon and Video Device cards, and the NDI card with two inputs, a source on the network with an Add button, Re-scan and Extra search IPs

Configure…, at the bottom of the Add Source menu, opens Settings → Project → Video. In a project with no inputs yet, the menu shows No video inputs yet above Web page… and Configure….

The Add Source menu open: an NDI heading over two inputs, a Spout / Syphon heading over one, then Web page… and Configure…

A source you add goes into the folder selected in the Asset Browser, like an upload.

Scanning for senders

The NDI and Video Device cards scan when you open Settings → Project → Video, and again if the connection to the show machine comes back while they're open. They share one scan, and they don't rescan on a timer, so press Re-scan to look again.

An empty NDI list right after startup

NDI senders announce themselves on the network. The show machine starts listening a moment after a project opens, so for the first few seconds it may not have heard any. The card says so:

No NDI sources are visible on this network yet. Discovery is asynchronous - senders take a few seconds after the project opens to announce themselves. Scan again.

Press Re-scan, and senders appear as they're heard.

While the list is empty, the card shows what it's doing: Looking for NDI sources… during a scan, Waiting for the show machine… while the connection is down, and Nothing else is visible from the show machine. when it hears no senders or every sender it hears is already an input.

You can scan once every 10 seconds. If you ask again sooner, the card shows the last scan's results and says so:

What you see What it means
Scanned at 14:02:07 A fresh scan
Showing the scan from 14:02:07 The results of the last scan; a new one isn't available yet
Re-scan in 6 s How long until you can scan again

If the show machine doesn't answer a scan within 8 seconds, the card says The show machine did not answer the scan. Press Re-scan to try again.

More than one item per sender

You can pick an input from Add Source as many times as you like. Each library item is a separate way of showing that sender, with its own Fit, so the same camera can fill one surface and fit another. The second item is named Logitech BRIO 2, the third Logitech BRIO 3, and so on. Duplicate on an item also makes another, named with copy added, and keeps its Fit.

The sender's own settings, such as a camera's Resolution, belong to its input in Settings → Project → Video, and every item of that input shares them: one resolution per camera. Video settings… in an item's details opens them.

You can add a web page more than once the same way, and each copy has its own settings.

Names are matched to the sender you meant

NDI and Spout names have to match exactly. If you type studio (cam 1) while STUDIO (Cam 1) is on the network, Moonshine adds STUDIO (Cam 1). If that sender is already an input, nothing is added and the card says “STUDIO (Cam 1)” is already an input. A name that matches no sender is added as you typed it, for a sender that isn't running yet.

Changing or removing an input

Each input in Settings → Project → Video has a Name and a sender: a Source to choose for an NDI input, a Device for a video device, or a Sender name to type for Spout. NDI and video device inputs also have receive settings below these (NDI, video device). The last line says whether the input is in the library, and under what name.

The same settings are on the menu of any cue that plays the input, on the Cue tab or in the timeline: right-click the cue and choose Parameters. They're still the input's settings, so a change there applies to every item and cue of that input.

  • Switch an input off with its Active toggle. A cue on it shows black until you switch it on again (Active). Switching an input off and on reconnects to the sender or device, which often clears a fault, such as a camera that stopped or a card that won't lock on.
  • Point an input at another sender, and every library item of that input follows. If one is playing, the show switches to the new sender at once.
  • Remove appears only on an input the library doesn't use. If the input is in use, a note under its fields says so. Delete its items from the library first, and Remove appears.

How an NDI input is received

Each NDI input has three receive settings, under its Name and Source. They start at the receiver's defaults, which suit almost every sender, and a change takes effect at once.

Setting What it does
Bandwidth high, the default, is the full-quality stream. low is NDI's proxy stream: a lower-quality version of the same picture that uses much less network bandwidth, meant for previews and multiviewers. Use it for a picture that won't be seen large, or on a network that can't carry the full stream.
Hardware Decode Decodes the stream on the show machine's graphics card instead of its processor. It applies only to NDI|HX streams, the compressed form some cameras and capture devices send. Most software sends full NDI, which this setting doesn't affect.
Input Color Space The color space of the sender's pixels. Automatic suits almost every sender. Change it only if a sender's colors look wrong, to the color space that sender uses.

How a video device is received

Each video device input has its own settings, under its Name and Device. They start at the driver's defaults, and a change takes effect at once.

Setting What it does
Resolution The resolution and frame rate to capture at, and whether it's interlaced, from the list the device reports: 1920x1080p 30Hz from a webcam, 1080i 50 from a capture card. Default (device's own) leaves it to the device. A capture card lists its resolutions straight away. A camera lists them only once it's open, so the show machine briefly opens each camera that isn't playing to read them. They appear a few seconds after the card opens; until then the list shows Default only.
Deinterlace For an interlaced signal: Off, Even or Odd fields, or Bob (Split).
Input Bit Depth 8, 10, 12 or 16 bits per channel, to match the signal.
Input Color Space The color space of the signal. Automatic suits almost every source.
Quad Link For a card that builds one 4K picture from four SDI inputs.

If you point an input at another Device, it keeps its settings except Resolution, which belonged to the old device.

One camera, one capture

The show machine opens each video device once, and every item of it shares that capture. Two items of one camera, each with its own Fit, can dissolve into each other. The same item twice in a row, or one item looping on its own, holds on screen instead of dissolving into itself.

Picture only

A video device plays its picture only. Its sound, such as a camera's microphone or audio embedded in an SDI or HDMI signal, isn't played yet.

Senders on another subnet

NDI finds senders by listening on the local network, which doesn't reach across a subnet or a VLAN. Use Extra search IPs, on the NDI card under On the network, to tell the show machine where else to look. Enter the IP addresses of the sending machines, separated by spaces, for example 192.168.20.15 192.168.20.16. Commas also work and are saved as spaces. Press Enter or click away to save.

The list belongs to the project. The show machine's scan checks those addresses, so a sender at one of them can appear under On the network, and every NDI source the show plays checks them too.

The field takes IP addresses only, not machine names. Anything else is rejected and nothing is saved:

“studio.local” is not an IPv4 address, such as 192.168.1.20.

These settings affect sources on air

Changing Bandwidth, Hardware Decode or Input Color Space resets that input's receiver at once, and changing Extra search IPs resets every NDI receiver. The source can drop for a moment while it reconnects, even on air. Set these during rehearsal, not during a show.

What the library shows

Live sources have no thumbnail. Instead, a source's card shows a signal icon and a line saying what kind of source it is and where it comes from:

NDI · STUDIO (Cam 1)
Video device · DeckLink Duo (1)
Spout · Resolume
Web page · https://clock.example.com/face
TouchDesigner Component · particles.tox

If a source's library name is the same as the sender's name, the line shows only the kind (Spout, for example), since the name above it says the rest.

The Sources filter in the Assets sidebar shows NDI, video device and Spout sources and web pages, and Tox shows components. When you select a source, the details pane shows Kind and Source (the exact address the show machine receives) in place of Format and Size. A web page shows its Address as a field you can edit instead (Web pages). A component keeps its Size, because it's a file. Selecting a source also shows its live picture at the top of its details (Checking a source). A component has no picture there until it plays.

The library card doesn't show whether a sender is still there

Adding a sender records its name. A camera unplugged this morning looks the same in the library as one that's working. To check a source, select it and look at its preview.

An NDI, video device or Spout source, or a web page, has no Replace File…, because there's no file behind it. Its Duplicate makes another item of the same sender, with its own Fit. A component has both, for administrators only.

A live source has no duration.

Checking a source

When you select an NDI, video device or Spout source or a web page that's Active, the top of its details shows a small live picture of it from the show machine, at two frames a second, marked Live · 2 fps. Nothing goes on air: you're looking at the source the show machine is already running. The picture updates while its details are on screen, and stops when you select something else or leave the tab.

You see What it means
Live · 2 fps over the picture The show machine is sending the picture now.
Last frame over the picture No new frame has arrived for two seconds, because the connection dropped or the show machine is busy. It returns to Live by itself.
Waiting for the page from the show machine (or the video device, or the sender) The picture has been requested and the first frame is on its way.
Off: turn it on to preview The source isn't Active, so it isn't running. Switch Active on (Active).
On, but the show machine has not opened it yet. The source is Active but not running, for example a camera that's unplugged.
4 sources are being previewed already. It shows when one closes. Four sources are being previewed at once, by you or anyone else. Yours appears as soon as one of them closes.

The preview is at most 320 pixels on its longest side. Use it to check that you have the right camera, sender or page. To see the picture full size, play it. Components have no preview, because a component starts only when it plays.

Playing a live source

Drag a source from the Asset Browser in the Cue tab's sidebar onto a cuelist, as you would a clip. It takes a length and a transition like any other item, and crossfades with the items beside it. A live source has no end, so its length decides when the cuelist moves on. Set it to the number of seconds you want the source on screen.

You can also put a source straight on a surface: wire it to the surface's Material node in the scene graph, as you would a clip. See Putting media on a surface.

An NDI, video device or Spout source or a web page that's Active is already running on the show machine, whether or not it's on screen. A cue on it, a jump to it or a scrub across the timeline shows it at once, with nothing to load or connect (Active).

A component starts when it's loaded for playback, which can happen while the cue before it is still playing, so it's ready when its turn comes. It keeps running while the cuelist still needs it. It stops when another item is loaded in its place, when it's removed from the cuelist, when another cuelist plays, when the cuelist is deleted, or when the last item of a cuelist that doesn't loop goes on air. Pausing doesn't stop it, so playback resumes at once.

Active

Every NDI, video device and Spout source and every web page has an Active switch, in its details on the Assets tab under Kind and Source.

  • On: the show machine keeps the source running for the whole project (the receiver connected, the camera open, the page loaded), so it's on screen the moment a cue calls for it.
  • Off: the source is closed and uses no resources. A cue on it shows black, and the cue's row and the item's details say Off: turn it on in its settings. The source stays off until you switch it on.

For an NDI, video device or Spout source, the switch belongs to its input. It's the same as the Active toggle in Settings → Project → Video, and every item of that sender or device shares it. Each web page has its own.

A source you add starts Active. Every Active source uses the show machine's resources all the time, so switch off the ones a show doesn't need. The first time you open a project made before October 2026, the sources its cues play stay on and the rest are switched off.

Web pages

The show machine draws a web page in its own browser, and you play it like any other source. Only the picture plays; a page's sound isn't played.

The Assets tab with a web page selected: the details open on General, with Kind Web page, its Fit and its Address, and a Parameters tab beside it

Its address

To change the address, select the page on the Assets tab, edit Address, and press Enter or click away. The same rules apply as when you add a page, and an incomplete address isn't saved; the field says why. The page loads the new address at once, even on air.

Its settings

A page has four settings on the Parameters tab of its details, beside General, split across two tabs: Common holds Resolution, and Web Render holds the other three.

A web page's Parameters tab: a Common tab and a Web Render tab under General and Parameters, Common open with Resolution width and height

Setting What it does
Resolution The size the page is drawn at, width and height in pixels. It starts at 1920 × 1080.
Transparent Background Loads the page with a transparent background.
Maximum Render Frame Rate The highest frame rate the page is drawn at.
Reload Current Page Loads the page again, like refreshing a browser. Its Pulse button works while the page is Active, whether or not it's on screen. While the page is off, the button is grayed out and its tooltip says Only while it is Active.

A change reaches the page at once wherever it's playing, and is saved with it.

Transparent Background restarts the page

Changing Transparent Background restarts the page's browser, which causes a visible blip if the page is on air. Set it during rehearsal, not during a show.

A web page keeps running when you pause. While it's Active, it runs for the whole project, so it has usually been open for a while by the time it goes on air. A countdown that starts when the page loads, for example, will already be under way. Each web page item is one page wherever it shows. If two cues of it have their own settings, each cue applies its settings as it goes on air.

A component is code

A .tox is a piece of TouchDesigner: operators, parameters and Python. When it plays, the show machine runs it, and it can do anything TouchDesigner can do on that machine, such as read files, open network connections and use the GPU.

That's what makes components useful, and it's why Moonshine handles them differently from video:

  • Only an administrator can add or replace one. Operators can rename, move and delete components, like any other item.
  • Add only components you trust, from people you trust, as you would a plugin or a script.
  • A component runs separately from the show. If one crashes, the show keeps running and the show machine restarts the component.
  • Replacing a component that's on air restarts it with the new file at once.

While a component loads, a status line in its details, on its cuelist row and on the transport reads Starting the engine…, then Loading the component…. If a component crashed and was restarted, the line reads Recovered from and the number of crashes.

What a component needs

A component must contain an Out TOP, which supplies the picture it plays. If it has none, Moonshine shows This .tox has no Out TOP, so it has no picture to play. Add an Out TOP to the component and re-upload it. An Out CHOP is optional and carries the component's sound; see Sound.

An Out CHOP named control carries the component's control data and is never played as sound. Give your sound's Out CHOP any other name.

A component's parameters

When you select a component on the Assets tab, the custom parameters on its top level appear on the Parameters tab of its details, beside General. The tab you pick stays selected as you move from one component to the next. An item with no parameters has no Parameters tab. Moonshine reads a component's parameters when you upload it, which can take up to a minute, and again each time it plays.

They're laid out as they are in TouchDesigner's parameter dialog:

  • One page at a time. A component with several pages has a tab for each, in its own order, under General and Parameters. It opens on its first page, and remembers the page you last picked until you reload the browser.
  • A Header is a title on its own line, in bold capitals, above the parameters under it.
  • A section (a parameter with Section on) starts with a thin line across, as in TouchDesigner. The first line of a page never has one.

On every page:

  • Change a value and it reaches the component at once wherever it's playing. The value is saved with the component and set again each time the component loads.
  • A Pulse is a button labeled Pulse, as in TouchDesigner. It works while the component is loaded for playback, on air or next up; otherwise it's grayed out. It lights while you hold it down.
  • File, Folder and operator parameters are shown read-only.
  • Moonshine doesn't show a parameter's help text, so give your parameters clear labels.

A cue's own parameters

The values on the component's Parameters tab apply wherever it plays. Each cue of it in a cuelist can also have its own values, so one component can play differently from cue to cue.

On the Cue tab, right-click the cue (or press and hold it on a phone or tablet, or click its ⋮) and choose Parameters. A clip in the timeline has the same option. The parameters open beside the menu, headed with the cue's number and the component's name, laid out as on the Assets tab. They stay open while you work; press Esc or click elsewhere to close them. On a phone they open in a panel along the bottom of the screen. A value you change there applies to that cue only:

  • A dot beside a parameter's name marks a value this cue sets. Every other parameter shows the component's value, and follows it if you change it on the Assets tab.
  • Reset, at the end of a parameter's name line, returns that parameter to the component's value. Reset all, at the top, does this for every parameter, and shows how many values the cue sets.
  • While the cue is on air, a change reaches the component at once. Otherwise it's applied when the cue plays.
  • A Pulse works while the component is loaded for playback, as on the Assets tab.

The values are saved with the cuelist, for everyone on the show. A web page's settings work the same way.

Treat a .tox like a program

A video file can't change anything on your show machine, but a component can. Moonshine doesn't inspect what's inside a .tox before running it, which is why only an administrator can add one.