Remote control (OSC)

ShowTrak apps can listen for OSC messages so you can trigger actions from lighting consoles, cue software, or custom tools.

Defaults

  • Server listens on UDP port 3333 at 0.0.0.0
  • Timers listens on the port you set in Settings (default 3333) and bind address you choose

Server routes (examples)

/ShowTrak/Shutdown
/ShowTrak/Client/:UUID/Select
/ShowTrak/Client/:UUID/Deselect
/ShowTrak/Client/:UUID/WakeOnLAN
/ShowTrak/Client/:UUID/RunScript/:ScriptID
/ShowTrak/All/WakeOnLAN
/ShowTrak/All/RunScript/:ScriptID

Timers routes (examples)

/ShowTrak/Timer/:TimerID/Start
/ShowTrak/Timer/:TimerID/Stop
/ShowTrak/Timer/:TimerID/Pause
/ShowTrak/Timer/:TimerID/Unpause
/ShowTrak/Timer/:TimerID/JumpToTime/:TimeInMS
/ShowTrak/All/Start
/ShowTrak/All/Stop
/ShowTrak/All/Pause
/ShowTrak/All/Unpause

Finding IDs

  • UUIDs (Server): open the Clients page and view client details.
  • Script IDs (Server): open the Scripts panel; IDs are shown.
  • Timer IDs (Timers): open the Timers list; IDs appear in the UI or OSC dictionary.

Notes

  • Route parameters use positional matching. Keep the exact segment order.
  • Success and error toasts appear in the apps for quick feedback.
  • Ensure your OSC sender targets the app’s IP and configured port, and that UDP is allowed by firewalls.

Route reference with examples

Below are all available routes with concrete examples and what each one does. Replace placeholders as shown:

  • UUID: a client’s unique ID, e.g., 7c9e6679-7425-40de-944b-e07fc1f90ae7
  • ScriptID: a numeric or string script ID shown in the Server’s Scripts panel, e.g., 42
  • TimerID: a numeric timer ID shown in Timers UI / OSC dictionary, e.g., 3
  • TimeInMS: milliseconds, e.g., 90000 for 1 min 30 sec

Notes:

  • These routes don’t require additional OSC arguments; the address path carries the parameters.
  • If a route can’t be processed (invalid ID, offline, port blocked), you’ll see an error toast.

Server routes

  • Close the Server app

    • Example: /ShowTrak/Shutdown
    • Behavior: Closes ShowTrak Server. A brief success toast may show before exit.

  • Select a client in the UI by UUID

    • Example: /ShowTrak/Client/7c9e6679-7425-40de-944b-e07fc1f90ae7/Select
    • Behavior: Selects the specified client, useful for building a selection set via OSC.

  • Deselect a client in the UI by UUID

    • Example: /ShowTrak/Client/7c9e6679-7425-40de-944b-e07fc1f90ae7/Deselect
    • Behavior: Removes the specified client from the current selection.

  • Wake a client by UUID (Wake‑on‑LAN)

    • Example: /ShowTrak/Client/7c9e6679-7425-40de-944b-e07fc1f90ae7/WakeOnLAN
    • Behavior: Sends a magic packet to wake that client (if its hardware/network supports WOL).

  • Run a script on a client

    • Example: /ShowTrak/Client/7c9e6679-7425-40de-944b-e07fc1f90ae7/RunScript/42
    • Behavior: Executes the script with ID 42 on the specified client; progress is shown in the Server.

  • Wake all offline clients

    • Example: /ShowTrak/All/WakeOnLAN
    • Behavior: Sends WOL to all offline clients known to the Server.

  • Run a script on all online clients

    • Example: /ShowTrak/All/RunScript/RestartComputer
    • Behavior: Executes the script with ID RestartComputer on every online client.

Timers routes

  • Close the Timers app

    • Example: /ShowTrak/Shutdown
    • Behavior: Closes ShowTrak Timers. A brief success toast may show before exit.

  • Start a specific timer

    • Example: /ShowTrak/Timer/3/Start
    • Behavior: Starts timer ID 3.

  • Stop (reset) a specific timer

    • Example: /ShowTrak/Timer/3/Stop
    • Behavior: Stops and resets timer ID 3 to its initial state.

  • Pause a specific timer

    • Example: /ShowTrak/Timer/3/Pause
    • Behavior: Pauses timer ID 3.

  • Unpause a specific timer

    • Example: /ShowTrak/Timer/3/Unpause
    • Behavior: Resumes timer ID 3 from pause.

  • Jump a timer to an exact elapsed time (milliseconds)

    • Example: /ShowTrak/Timer/3/JumpToTime/90000
    • Behavior: Sets timer ID 3 to 90,000 ms (1:30). Useful for cueing to a mark.

  • Start all timers

    • Example: /ShowTrak/All/Start
    • Behavior: Starts every timer.

  • Stop (reset) all timers

    • Example: /ShowTrak/All/Stop
    • Behavior: Stops and resets every timer.

  • Pause all timers

    • Example: /ShowTrak/All/Pause
    • Behavior: Pauses every timer.

  • Unpause all timers

    • Example: /ShowTrak/All/Unpause
    • Behavior: Resumes every paused timer.