ACTIONS

Actions:

tclinit

This action will start the track listener mode. This action will be automatically called when you add the first track.

Options: [] tclinit track

[] tclinit grid X Y starts the Track Listener with X Tracks and Y Slots

tcl

Parameters:

  • log: turns on logging
  • extlog: turns on extened logging
  • –version: logs and shows the action version
  • –test: same as –version
  • add: adds a track to the end of the listener grid
  • reload: refreshes the grid manually
  • disconnect: stops the listener, clears the OSC view
  • track follow on / off: turns on or off the track follow mode. you need to hand over a track which is already in the grid. Now it follow the position of the current playing clip in the targeted track.
  • scene follow on / off: turns on or off scene follow mode. whenever a scene is triggered the grid moves accordingly
  • follow offset (int): set an offset to display to the current playing scene. typically you would use 1 to display the scene / clipslot above/before the currently playing one.
  • up / down: move the grid manually up or down
  • scene SEL : moves the grid to the currently selected scene
  • scene “NAME” / (int) this moves the grid to to a specific scene either by name or position

tclfollow

Starts or stops the behaviour if the grid follows a triggered scene or a clip in the follow track

tclclear

Clears all OSC Data (refresh)

tcllog

turns on logging, and writes a log file?

tcltest

? no idea anymore what that does

updateosc

refreshes all OSC data

tcltrigger

action used for the TouchOSC Template to:

  • tcltrigger nr_track nr_clip
  • tcltrigger scene nrscene
  • mode switching:
    • tcltrigger select mode
    • tcltrigger trigger mode

expxosc

wites a .txt file with all the X-OSC Controls which you then can copy. it is not nescessary, because the next action does this automatically..

writexosc

this will catch the current configuration of the actual grid / track listner and write all x-osc actions into the X-OSC.txt file. It also wil backup your exsisting file just in case.

title: “Action Reference” weight: 2

Actions

tclinit

Initializes the listener engine. This must be run before the grid will work.

  • [] TCLINIT GRID [Tracks] [Scenes]
    • Starts the listener in Grid Mode.
    • Example: [] TCLINIT GRID 8 8 (Creates an 8x8 Grid).
  • [] TCLINIT TRACK
    • Starts the listener in Track Mode (allows adding specific non-adjacent tracks manually).

tcl

The main control action for the grid. It accepts various arguments to navigate or modify the view.

Logging & Debugging:

  • log / extlog: Turns on standard or extended logging.
  • --version: Displays the current version.

Navigation:

  • up / down: Scrolls the grid vertically by 1 scene.
  • left / right: Scrolls the grid horizontally by 1 track (Grid Mode only).
  • scene sel: Jumps the grid to the currently selected scene.
  • scene [Name]: Jumps the grid to a specific scene by name.
  • scene [ID]: Jumps the grid to a specific scene index.

Follow Modes:

  • scene follow on/off: Toggles whether the grid automatically scrolls to follow the triggered scene.
  • follow offset [Int]: Sets the visual offset for scene follow.
  • track follow on/off: (Requires a target track) The grid will center on the track containing the currently playing clip.

Management:

  • reload: Manually refreshes all grid data.
  • disconnect: Stops the listener and clears the OSC view.
  • add: (Track Mode only) Adds the targeted track to the listener list.

tclfollow

A shortcut to toggle follow behaviors on specific tracks.

  • Usage: [] [Track] / TCLFOLLOW
  • Sets the targeted track as the leader for “Track Follow” mode.

tclclear

Clears all data sent to TouchOSC. This effectively “blanks” the screen on the remote.

updateosc

Forces a full update of all OSC addresses. Useful if the remote device fell asleep or disconnected and needs to catch up with the current state of Live.

tcltrigger

The internal action used by the TouchOSC template to interact with Live.

  • tcltrigger [TrackIndex] [ClipIndex]: Launches the clip at that coordinate.
  • tcltrigger scene [SceneIndex]: Launches the scene at that index.
  • tcltrigger select mode: Switches button behavior to Select (Focus only).
  • tcltrigger trigger mode: Switches button behavior to Trigger (Launch).

writexosc

Automatically configures the X-OSC.txt file.

  1. Backs up your current X-OSC.txt.
  2. Writes all necessary tcltrigger bindings for the current grid size.
  3. Reloads ClyphX Pro settings.
  • Note: Run this whenever you change the SLOTS or GRIDTRACKS count in settings.