CueLAN - User Guide

Sound cues over local network

Quick Start

  • Enable OSC Remote Control in app Settings.
  • Send UDP OSC to 127.0.0.1:9000 (or device IP over LAN).
  • In-app command list is at Settings → OSC Help & Print.
  • Run Settings → Run Cue Health Check before show.
  • Feedback channel (app → Stream Deck plugin): UDP 127.0.0.1:9001.
  • Stream Deck can request a full status snapshot with /sc2/feedback/request.
  • Optional command ACK metadata: append string arg sc2cmd:<id>.

Mission-Critical Cue Policy

  • Use Files imports for show cues (stored in app-local storage).
  • Keep Apple Music as convenience-only.
  • Preflight warnings/errors should be resolved before showtime.

In-App Help

The app help screen is available at Settings → OSC Help & Print. It is copy/share/print capable for run-sheet style use.

Cue Trigger

  • /cue <n>
  • /cue/<n>
  • /trigger <n>
  • /trigger/<n>
  • n range: 1..125 (0 also maps to cue 1).

Transport

  • /playpause
  • /play
  • /stop
  • /fade
  • Aliases: /transport/playpause, /transport/stop, /transport/fade

Banks

  • /bank/up
  • /bank/down
  • /bank <n>
  • Aliases: /page/up, /page/down, /page <n>

Master Volume

  • /volume/up [step]
  • /volume/down [step]
  • /volume <value>
  • Aliases: /master/volume/up, /master/volume/down, /master/volume
  • step default: 0.05
  • step and value accept either 0.0..1.0 or 0..100.

Master Volume (dB Step)

  • /volume/db/up [dB]
  • /volume/db/down [dB]
  • Aliases: /master/volume/db/up, /master/volume/db/down
  • dB default: 3. If omitted, each trigger changes level by 3 dB.
  • Valid dB argument range: > 0 up to 60.

Examples

  • /cue 7
  • /playpause
  • /bank/down
  • /volume/up 0.1
  • /volume 65
  • /volume/db/up 3
  • /volume/db/down 3

Feedback (App → Stream Deck Plugin)

The app sends these OSC messages for state feedback:

  • /sc2/state/osc/enabled, /sc2/state/osc/disabled
  • /sc2/state/heartbeat
  • /sc2/state/transport/play, /sc2/state/transport/pause, /sc2/state/transport/stop
  • /sc2/state/fade/active, /sc2/state/fade/inactive
  • /sc2/state/bank/<n>
  • /sc2/state/volume/<percent>
  • /sc2/state/cue/<n> (0 means no active cue)
  • /sc2/state/remaining/<seconds>
  • /sc2/state/lastcmd/ok/<id>, /sc2/state/lastcmd/error/<id>

Back to Support | Return to Home