Commange OSC Live Ableton .pdf

1 CALLS
2 =====
3
4 /live/tempo                                                 
           Request current tempo, replies with /live/tempo
(float tempo)
5 /live/tempo             (float tempo)                       
           Set the tempo, replies with /live/tempo (float
tempo)
6 /live/time                                                   
          Request current song time, replies with /live/time
(float time)
7 /live/time              (float time)                         
          Set the time , replies with /live/time (float time)
8 /live/overdub           (int on/off)                         
          Enables/disables overdub
9 /live/state                                                 
           Returns the current tempo and overdub status
1 /live/undo                                                   
0           Requests the song to undo the last action
1 /live/redo                                                   
1           Requests the song to redo the last action
1
2
1 /live/next/cue                                               
3           Jumps to the next cue point
1 /live/prev/cue                                               
4           Jumps to the previous cue point
1 /live/play                                                   
5           Starts the song playing
1 /live/play/continue                                         
6            Continues playing the song from the current point
1 /live/play/selection                                         
7           Plays the current selection
1 /live/play/clip         (int track, int clip)               
8            Launches clip number clip in track number track
1 /live/play/clipslot     (int track, int clip)               
9            Launches clip number clip in track number track
even if a clip isnt present in the slot (ie stops the slot)
2 /live/play/scene        (int scene)                         
0            Launches scene number scene
2 /live/stop                                                   
1           Stops playing the song
2 /live/stop/clip         (int track, int clip)               
2            Stops clip number clip in track number track
2 /live/stop/track        (int track)                         
3            Stops track number track
2
4
2 /live/scenes            blank or ('query')                   
5           Returns the total number of scenes in the form /
live/scenes (int)
2 /live/tracks            blank or ('query')                   
6           Returns the total number of tracks in the form /
live/tracks (int)
2

2
2
2
3
2
4
2
5

/live/stop/clip         (int track, int clip)               
           Stops clip number clip in track number track
/live/stop/track        (int track)                         
           Stops track number track

/live/scenes            blank or ('query')                   
          Returns the total number of scenes in the form /
live/scenes (int)
2 /live/tracks            blank or ('query')                   
6           Returns the total number of tracks in the form /
live/tracks (int)
2
7
2 /live/scene                                                 
8            Returns the currently selected scene index
2 /live/scene             (int scene)                         
9            Selects the scene with index scene
3
0
3 /live/name/scene        blank or ('query')                   
1           Returns a a series of all the scene names in the
form /live/name/scene (int scene, string name)
3 /live/name/scene        (int scene)                         
2            Returns a single scene's name in the form /live/
name/scene (int scene, string name)
3 /live/name/scene        (int scene, string name)             
3           Sets scene number scene's name to name
3 /live/name/sceneblock   (int track, int size)               
4            Returns a series of scene name starting at (int
scene) of length (int size)
3
5
3 /live/name/track                                             
6           Returns a a series of all the track names in the
form /live/name/track (int track, string name, int color)
3 /live/name/track        (int track)                         
7            Returns a single track's name in the form /live/
name/track (int track, string name, int color)
3 /live/name/track        (int track, string name)             
8           Sets track number track's name to name
3 /live/name/trackblock   (int track, int size)               
9            Returns a series of track name starting at (int
track) of length (int size)
4
0
4 /live/name/clip                                             
1            Returns a a series of all the clip names in the
form /live/name/clip (int track, int clip, string name)
4 /live/name/clip         (int track, int clip)               
2            Returns a single clip's name in the form /live/
name/clip (int clip, string name)
4 /live/name/clip         (int track, int clip, string name)   
3           Sets clip number clip in track number track's name
to name
4 /live/name/clipblock    (int track, int clip, int sizeX, int
4 sizeY)     Returns a series of clip names in a area starting
at (int track, int clip) of size (sizeX, sizeY)
4
5
4 /live/arm               (int track)                         
6            Get arm status for track number track
4 /live/arm               (int track, int armed/disarmed)     

4 /live/name/clip         (int track, int clip, string name)   
3           Sets clip number clip in track number track's name
to name
4 /live/name/clipblock    (int track, int clip, int sizeX, int
4 sizeY)     Returns a series of clip names in a area starting
at (int track, int clip) of size (sizeX, sizeY)
4
5
4 /live/arm               (int track)                         
6            Get arm status for track number track
4 /live/arm               (int track, int armed/disarmed)     
7            Arms/disamrs track number track
4 /live/mute              (int track)                         
8            Get mute status for track number track
4 /live/mute              (int track, int mute/unmute)         
9           Mutes/unmutes track number track
5 /live/solo              (int track)                         
0            Get solo status for track number track
5 /live/solo              (int track, int solo/unsolo)         
1           Solos/unsolos track number track
5 /live/volume            (int track)                         
2            Returns the current volume of track number track
as: /live/volume (int track, float volume(0.0 to 1.0))
5 /live/volume            (int track, float volume(0.0 to
3 1.0))           Sets track number track's volume to volume
5 /live/pan               (int track)                         
4            Returns the pan of track number track as: /live/
pan (int track, float pan(-1.0 to 1.0))
5 /live/pan               (int track, float pan(-1.0 to 1.0)) 
5            Sets track number track's pan to pan
5 /live/send              (int track)                         
6            Returns a list of all sends and values on track
number track as: /live/send (int track, int send, float
level, int send, ...)
5 /live/send              (int track, int send)               
7            Returns the send level of send (send) on track
number track as: /live/send (int track, int send, float level
(0.0 to 1.0))
5 /live/send              (int track, int send, float level(0.0
8 to 1.0))  Sets the send (send) of track number (track)'s
level to (level)
5 /live/pitch             (int track, int clip)               
9            Returns the pan of track number track as: /live/
pan (int track, int clip, int coarse(-48 to 48), int fine
(-50 to 50))
6 /live/pitch             (int track, int clip, int coarse(-48
0 to 48),
6                         int fine (-50 to 50))               
1            Sets clip number clip in track number track's
pitch to coarse / fine
6
2
6 /live/return/mute       (int track)                         
3            Get mute status for return track number track
6 /live/return/mute       (int track, int mute/unmute)         
4           Mutes/unmutes return track number track
6 /live/return/solo       (int track)                         
5            Get solo status for return track number track
6 /live/return/solo       (int track, int solo/unsolo)         
6           Solos/unsolos return track number track
6 /live/return/volume     (int track)                         
7            Returns the current volume of return track number
track as: /live/volume (int track, float volume(0.0 to 1.0))

6
2
6
3
6
4
6
5
6
6
6
7
6
8
6
9
7
0
7
1

7
2

7
3

/live/return/mute       (int track)                         
           Get mute status for return track number track
/live/return/mute       (int track, int mute/unmute)         
          Mutes/unmutes return track number track
/live/return/solo       (int track)                         
           Get solo status for return track number track
/live/return/solo       (int track, int solo/unsolo)         
          Solos/unsolos return track number track
/live/return/volume     (int track)                         
           Returns the current volume of return track number
track as: /live/volume (int track, float volume(0.0 to 1.0))
/live/return/volume     (int track, float volume(0.0 to
1.0))           Sets return track number track's volume to
volume
/live/return/pan        (int track)                         
           Returns the pan of return track number track as: /
live/pan (int track, float pan(-1.0 to 1.0))
/live/return/pan        (int track, float pan(-1.0 to 1.0)) 
           Sets return track number track's pan to pan
/live/return/send       (int track)                         
           Returns a list of all sends and values on return
track number track as: /live/send (int track, int send, float
level, int send, ...)
/live/return/send       (int track, int send)               
           Returns the send level of send (send) on return
track number track as: /live/send (int track, int send, float
level(0.0 to 1.0))
/live/return/send       (int track, int send, float level(0.0
to 1.0))  Sets the send (send) of return track number
(track)'s level to (level)

7
4
7 /live/master/volume     (int track)                         
5            Returns the current volume of the master track
as: /live/master/volume float volume(0.0 to 1.0)
7 /live/master/volume     (int track, float volume(0.0 to
6 1.0))           Sets the master track's volume to volume
7 /live/master/pan        (int track)                         
7            Returns the pan of the master track as: /live/
master/pan (int track, float pan(-1.0 to 1.0))
7 /live/master/pan        (int track, float pan(-1.0 to 1.0)) 
8            Sets master track's pan to pan
7
9
8 /live/track/jump        (int track, float beats)             
0           Jumps in track's currently running session clip by
beats
8 /live/track/info        (int track)                         
1            Returns clip slot status' for all clips in a track
in the form /live/track/info (tracknumber, armed 
(clipnumber, state, length))
8                                                              
2           [state: 0 = no clip, 1 = has clip, 2 = playing, 3 =
triggered]
8 /live/track/view        (int track)                         
3            Selects a track to view
8 /live/return/view       (int track)                         
4            Selects a return track to view
8 /live/master/view                                           
5            Selects the master track
8

(clipnumber, state, length))
8                                                              
2           [state: 0 = no clip, 1 = has clip, 2 = playing, 3 =
triggered]
8 /live/track/view        (int track)                         
3            Selects a track to view
8 /live/return/view       (int track)                         
4            Selects a return track to view
8 /live/master/view                                           
5            Selects the master track
8
6
8 /live/track/device/view (int track, int device)             
7            Selects device on track to view
8 /live/return/device/view (int track, int device)             
8           Selects device on return track to view
8 /live/master/device/view (int device)                       
9            Selects device on the master track
9
0
9 /live/clip/view         (int track, int clip)               
1            Selects a clip on track to view
9
2
9 /live/detail/view       (int)                               
3            Switches detail view [0 = clip, 1 = track]
9
4
9 /live/clip/info         (int track, int clip)               
5            Gets the status of a single clip in the form  /
live/clip/info (tracknumber, clipnumber, state)
9                                                              
6           [state: 0 = no clip, 1 = has clip, 2 = playing, 3 =
triggered]
9
7
9 /live/devicelist        (int track)                         
8            Returns a list of all devices and names on track
number track as: /live/device (int track, int device, str
name, ...)
9 /live/device            (int track, int device)             
9            Returns a list of all parameter values and names
on device on track number track
1                                                              
0           as: /live/deviceall/param (int track, int device,
0 int parameter int value,  str name, ...)
1 /live/device            (int track, int device, int
0 parameter)          Returns the name and value of parameter
1 on device on track as: /live/device/param (int track, int
device, int paarmeter, int value, str name)
1 /live/device            (int track, int device, int
0 parameter,          Sets parameter on device on track number
2 track to value
1                         int value)
0
3
1
0
4
1 /live/device/range      (int track, int device)             
0            Returns the min and max value of all parameters of
5 device on track in the format /live/device/range (int track,
int device, int/float min, int/float max, ...)

1
0
2
1
0
3
1
0
4
1
0
5

/live/device            (int track, int device, int
parameter,          Sets parameter on device on track number
track to value
                        int value)

/live/device/range      (int track, int device)             
           Returns the min and max value of all parameters of
device on track in the format /live/device/range (int track,
int device, int/float min, int/float max, ...)
1 /live/device/range      (int track, int device, int
0 parameter)          Returns the min and max value of
6 parameter of device on track in the format /live/device/range
(int track, int device, int/float min, int/float max)
1
0
7
1 /live/return/devicelist (int track)                         
0            Returns a list of all devices and names on track
8 number track as: /live/device (int track, int device, str
name, ...)
1 /live/return/device     (int track, int device)             
0            Returns a list of all parameter values and names
9 on device on track number track
1                                                              
1           as: /live/device/allparm (int track, int device,
0 int parameter int value,  str name, ...)
1 /live/return/device     (int track, int device, int
1 parameter)          Returns the name and value of parameter
1 on device on track as: /live/device/param (int track, int
device, int parameter, int value)
1 /live/return/device     (int track, int device, int
1 parameter,          Sets parameter on device on track number
2 track to value
1                         int value)
1
3
1
1
4
1 /live/return/device/range (int track, int device)           
1            Returns the min and max value of all parameters of
5 device on return track in the format /live/return/device/
range (int track, int device, int/float min, int/float
max, ...)
1 /live/return/device/range (int track, int device, int
1 parameter)        Returns the min and max value of parameter
6 of device on return track in the format /live/return/device/
range (int track, int device, int/float min, int/float max) 
                     
1
1
7
1 /live/master/devicelist                                     
1            Returns a list of all devices and names on the
8 master track as: /live/device (int device, str name, ...)
1 /live/master/device     (int device)                         
1           Returns a list of all parameter values and names on
9 device on the master track
1                                                              
2           as: /live/device (int device, int parameter int

1
1
7
1
1
8
1
1
9
1
2
0
1
2
1

/live/master/devicelist                                     
           Returns a list of all devices and names on the
master track as: /live/device (int device, str name, ...)
/live/master/device     (int device)                         
          Returns a list of all parameter values and names on
device on the master track
                                                             
          as: /live/device (int device, int parameter int
value,  str name, ...)
/live/master/device     (int device, int parameter)         
           Returns the name and value of parameter on device
on the master track as: /live/device (int device, int
parameter, int value)
1 /live/master/device     (int device, int parameter, int
2 value)          Sets parameter on device on track number
2 track to value
1
2
3
1 /live/return/device/range (int device)                       
2           Returns the min and max value of all parameters of
4 device on the master track in the format /live/master/device/
range (int device, int/float min, int/float max, ...)
1 /live/return/device/range (int device, int parameter)       
2            Returns the min and max value of parameter of
5 device on the master track in the format /live/master/device/
range (int device, int/float min, int/float max)         
1
2
6
1 /live/clip/loopstart    (int track, int clip)               
2            Get the loopstart for clip in track
7
1 /live/clip/loopstart    (int track, int clip, float
2 loopstart)          Set the loop start position for clip in
8 track
1 /live/clip/loopend      (int track, int clip)               
2                Get the loopend for clip in track
9
1 /live/clip/loopend      (int track, int clip, float loopend) 
3           Set the loop end position for clip in track
0
1 /live/clip/loopstate    (int track, int clip)               
3            Get the loop state of clip on track
1
1 /live/clip/loopstate    (int track, int clip, int on/off)   
3            Set the loop state of clip on track
2
1
3
3
1 /live/clip/loopstart_id (int track, int clip)               
3            Get the loopstart for clip in track with the track
4 and clip id /live/clip/loopstart_id (int track, int clip,
float start)
1 /live/clip/loopend_id   (int track, int clip)               
3            Get the loopend for clip in track with the track
5 and clip id /live/clip/loopend_id (int track, int clip, float
end)
1 /live/clip/loopstate_id (int track, int clip)               
3            Get the loop state of clip on track with the track

3
3
1 /live/clip/loopstart_id (int track, int clip)               
3            Get the loopstart for clip in track with the track
4 and clip id /live/clip/loopstart_id (int track, int clip,
float start)
1 /live/clip/loopend_id   (int track, int clip)               
3            Get the loopend for clip in track with the track
5 and clip id /live/clip/loopend_id (int track, int clip, float
end)
1 /live/clip/loopstate_id (int track, int clip)               
3            Get the loop state of clip on track with the track
6 and clip id /live/clip/loopstate_id (int track, int clip, int
state)
1
3
7
1 /live/clip/warping      (int track, int clip)               
3            Gets the warping state of the clip
8
1 /live/clip/warping      (int track, int clip, int state)     
3           Sets the warping state of the clip
9
1
4
0
1 /live/clip/signature    (int track, int clip)               
4            Gets the time signature of a clip returns 4 4 for
1 example
1 /live/clip/signature    (int track, int clip, int denom, int
4 num)       Sets the time signature of a clip
2
1
4
3
1 /live/master/crossfader                                     
4            Get the current crossfader position
4
1 /live/master/crossfader (float position)                     
4           Set the crossfader position
5
1
4
6
1 /live/quantization (int)                                     
4           Set the global quantization. 0=None, 1=8bars,
7 2=4bars, 3=2bars, 4=bar, 5=half, 6=half triplet, 7=quarter,
8=quarter triplet, 9=8th, 10=8thT, 11=16th, 12=16T, 13=32nd
1
4
8
1 /live/track/crossfader  (int track)                         
4            Gets the current cross fader assignment for track
9 track. 0 = A, 1 = None, 2 = B
1 /live/track/crossfader  (int track) (int assign)             
5           Sets the current cross fader assignment for track
0 track to assign
1 /live/return/crossfader (int return)                         
5           Gets the current cross fader assignment for return
1 track track
1 /live/return/crossfader (int return) (int assign)           
5            Sets the current cross fader assignment for return
2 track track
1

1
4
9
1
5
0
1
5
1
1
5
2
1
5
3
1
5
4
1
5
5
1
5
6
1
5
7
1
5
8
1
5
9
1
6
0
1
6
1
1
6
2
1
6
3
1
6
4
1
6
5
1
6
6
1
6
7
1
6
8
1
6
9
1
7

/live/track/crossfader  (int track)                         
           Gets the current cross fader assignment for track
track. 0 = A, 1 = None, 2 = B
/live/track/crossfader  (int track) (int assign)             
          Sets the current cross fader assignment for track
track to assign
/live/return/crossfader (int return)                         
          Gets the current cross fader assignment for return
track track
/live/return/crossfader (int return) (int assign)           
           Sets the current cross fader assignment for return
track track

/live/selection (int tr_offset, int sc_offset, int width, int
height)   Sets the dimensions and positions of the
highlighted region in session view

LISTENERS

=========

The following functions will automatically return a value
when the specific controller changes in ableton
without the need for a polling call

/live/play (2 = playing, 1 = stopped)

/live/track/info

/live/clip/info

/live/clip/position (int track) (int clip) (float position)
(float length) (float loop_start) (float loop_end)

/live/name/return

/live/name/track

/live/name/clip (returns on colour and name changes)

1
6
6
1
6
7
1
6
8
1
6
9
1
7
0
1
7
1
1
7
2
1
7
3
1
7
4
1
7
5
1
7
6
1
7
7
1
7
8
1
7
9
1
8
0
1
8
1
1
8
2
1
8
3
1
8
4
1
8
5
1
8
6
1
8

/live/clip/position (int track) (int clip) (float position)
(float length) (float loop_start) (float loop_end)

/live/name/return

/live/name/track

/live/name/clip (returns on colour and name changes)

/live/arm

/live/mute

/live/solo

/live/volume

/live/pan

/live/send

/live/master/volume

/live/master/pan

/live/master/crossfader

/live/return/mute

/live/return/solo

/live/return/volume

/live/return/pan

/live/return/send

1
8
4
1
8
5
1
8
6
1
8
7
1
8
8
1
8
9
1
9
0
1
9
1
1
9
2
1
9
3
1
9
4
1
9
5
1
9
6
1
9
7
1
9
8
1
9
9
2
0
0
2
0
1
2
0
2
2
0
3
2
0
4
2
0

/live/return/solo

/live/return/volume

/live/return/pan

/live/return/send

/live/overdub

/live/tempo

/live/scene

/live/track

/live/master/meter (int 0=left, 1=right) (float value)

/live/return/meter (int track) (int 0=left, 1=right) (float
value)
/live/track/meter (int track) (int 0=left, 1=right) (float
value)

/live/device/param (int track) (int device) (int param) (int
value) (str name)
/live/return/device/param (int track) (int device) (int
param) (int value) (str name)
/live/master/device/param (int device) (int param) (int
value) (str name)

/live/device/selected (int track) (int deviceid)

/live/return/device/selected (int track) (int device)

/live/master/device/selected (int device)

2 /live/device/selected (int track) (int deviceid)
0
2
2 /live/return/device/selected (int track) (int device)
0
3
2 /live/master/device/selected (int device)
0
4
2
0
5