SHOWKONTROL(1)ShowKontrol R27SHOWKONTROL(1)

Quick Reference

Name#

ShowKontrol R27 reads a PRO DJ LINK network (CDJs, DJM, rekordbox) and TCNet, sends the live data through the Patch, and drives timecode, lighting, video, MIDI, OSC, cues and the players themselves.

Synopsis#

Source ─▶ Device ─▶ [Router] ─▶ Trigger ─▶ Action | Output
  bundle    one deck   one of 8     when         what

• Right-click the Patch: Add Source · Add Processor · Add Controller · Add Output. A node added from a node is wired to it automatically.
• Double-click a node to open its editor or interior (Script, Graphic, Group, Device, Router, OSC In).
• Node title bar: ● bypass (data passes through untouched) · ■ stop (passes nothing) · ▶ fire by hand.

Keyboard & mouse#

• Wheel over the canvas: zoom (keeps the point under the cursor fixed).
• Wheel over Live Data: scroll the list.
• 1–8 with a Router selected: set active input. 1–4 with a Matrix: recall preset.
• Shift+drag (background): rubber-band select. Shift+click: Toggle selection.
• Drag a node: Moves just that node (multi-selected nodes move together). Hold Shift while dragging: The node's whole downstream subtree comes along.
• Delete/Backspace: Remove the selected node(s), downstream nodes stay, wires drop. Shift+Delete: Remove the node(s) AND everything downstream.
• ⌘N / ⌘O / ⌘S: New / open / save a show (.skshow, the working copy auto-saves too).
• Ctrl+Esc (anywhere): lock / unlock the machine.
• Patch view strip (right edge of the node graph): zoom in / out, centre, align-snap (hold ⌘ while dragging to place a node freely).
• Cue Editor: C = a one-cell cue at the needle (needle to its end); ⌘C / ⌘X / ⌘V act on clips when a lane / clip was clicked last, on cues otherwise; double-click an empty cue-lane cell (zoomed in) = a one-cell cue; drag a cue mark under the ruler = move that cue.

Nodes#

Trigger events#

Release Delay = how long the trigger stays active = the tap or note length. Use beat.msToNextBeat for a tap exactly one beat long. Downstream keys: trigger.active trigger.value trigger.fireCount.

Action categories#

Script#

system.beep = CDJ1.beat.bar;                   // read with bare names
value.x = source.metadata.title;               // source.* = the input as it came in
output.MainRouter.router.active = "Input 2";   // any node, by name
output.FX.node.bypassed = true;                // bypass / stop any node
output.parent.led.play = 1;                    // the node that owns the data
output.child.node.bypassed = true;             // what this script feeds
output.CDJ1.setting.quantize = 1;              // write to the player (enforced)
g.clear("#000"); g.text(8, 20, "Hi", "#fff");  // draw on a Graphic node

Data namespaces#

Every key is prefixed with its owner's name: CDJ1.beat.bar. Trigger, MIDI, OSC, DMX and CSV fields match by suffix. Scripts use the full name.

Text variables#

$TIME $DATE $BPM $TITLE $ARTIST $KEY $DECK $REMAIN $ELAPSED $TIMECODE $BEAT $PITCH $CUE $NEXTCUE $CUEIN $SECTION $PROGRAM $NEXT $VENUE $STAGE $SHOW $TRACKCOLOR $COUNTDOWN $COUNTDOWNLABEL $COUNTER

Use them in OSD text, UDP messages, Stream Deck text, notifications and stage messages. ${any.key} puts in the live value of any data key, where templates allow it.

Network ports#

Files#

All under ~/Documents/TC Supply/:

See also#

Learning Base · Manual · Data Key Reference · What's New