Skip to content

Break Music and Ads

Michael Riddle edited this page Aug 24, 2026 · 1 revision

Break Music and Ads

Two separate services that feed the same screens: break music fills the room between singers, and ads take the gap after a performance. Both draw from playlists, and neither ever interrupts a singer.

Priority

Break music < Ad < Karaoke. A song takes the room from an ad that is still running, an ad takes it from break music, and an ad is refused outright while a performance is loaded — it waits for the gap rather than cutting a singer short.

The one exception is silence. An ad that is a still image has no audio of its own, so break music keeps playing underneath it instead of dropping the room into fifteen seconds of nothing. Anything with its own sound suspends the bed.

Media types

A media row is one of Karaoke, Video, Audio, or Image — what the file is, not what it is for. There is no "ad" type: an ad is composed in a playlist out of the others.

Karaoke is what the queue plays: an mp4, or a cdg+mp3 pair. Karaoke tracks are deliberately not offered as break music even though many are audio files — they have no singer on them and are usually not the original recording, so they are not songs to play to a room.

Playlists

A playlist (MediaPool) has a purpose — BreakMusic or Ads — and belongs to a venue. Entries are media rows or other playlists, so a venue can keep "80s" and "chill" separately and still run both from one list.

Selection is Sequential (the order the host arranged, wrapping at the end), Shuffle (even chance, ignoring weight), or Weighted (chance proportional to an entry's weight). A no-repeat window — NoRepeatCount, default 3 — keeps a shuffle from playing the same track twice in a row.

When an ad runs

Only one ad playlist runs per venue at a time. Its AdTrigger decides when it comes due:

Trigger Meaning
HostOnly Never on its own — the host presses the button
EveryNPerformances After every N songs (AdTriggerInterval)
EveryNMinutes On a clock
OnIdle Whenever the queue runs dry

Counters only move on an ad that actually reached the screen — a refusal (no screen connected, a broken file) leaves it due so the next gap tries again rather than skipping the slot.

Images

An image ad has no length of its own, so the host clock runs it out. How it fills the screen is per media row: Fit (whole picture, bars where the shapes disagree), Fill (fills the screen, cropping the overhang), Stretch (fills it by distorting), or Original.

Volume

There is one volume: the venue's. It is a baseline so the host does not have to touch the computer's master volume when plugging into a different venue's mixer — karaoke, ads and break music all come out at it. Editing it on the venue the console is currently running re-applies it to the screens immediately; editing any other venue does not touch the room.

Providers

Break music comes from a provider. The built-in one plays from the library, and its audio rides the screen's second channel — so it reaches a Cast device and needs a screen connected. A plugin can register another (driving Spotify or Pandora on the same machine), whose sound comes out of that app's own output where the host cannot route or mix it. IBreakMusicProvider.RendersThroughHost is how the host tells the two apart.

A provider raises no events: it publishes BreakMusicTrackChanged on the broker when it moves to another track on its own. See Messaging.

Clone this wiki locally