ALS clips and notes

Clips live in a track’s MainSequencer. Session clips are in ClipSlotList/ClipSlot/ClipSlot/Value (the slot and its contents are nested), and Arrangement clips are in ClipTimeable/ArrangerAutomation/Events. Times in a clip are in beats. Names marked † are inferred from PyAbleton’s Python attribute names.

MidiClip

A MidiClip has an Id attribute. Its position is Time, in beats: an attribute in PyAbleton’s reading, a child element in one published example. It has these children:

Element	Holds
`LomId`, `LomIdView`	Live Object Model identifiers.
`Time`, `Duration`	Clip start and length in beats, in the published example.
`CurrentStart`, `CurrentEnd`	The clip’s region on the timeline.†
`Loop`	See loop.
`Name`, `Annotation`	Clip name and note.
`Color` or `ColorIndex`	The clip colour.
`LaunchMode`, `LaunchQuantisation`	Launch behaviour.†
`Legato` or `HasLegato`	Whether legato mode is on. Both spellings appear.
`Ram`, `Disabled`	RAM mode and disabled state.†
`VelocityAmount`	Velocity sensitivity of launching.†
`FreezeStart`, `FreezeEnd`	Frozen region.†
`IsWarped`	Whether the clip follows tempo.†
`TakeId`	Associated take.†
`Notes`	The note data. See notes.
`BankSelectCoarse`, `BankSelectFine`, `ProgramChange`	Bank and program sent on launch.†
`NoteEditorFoldInZoom`, `NoteEditorFoldInScroll`, `NoteEditorFoldOutZoom`, `NoteEditorFoldOutScroll`, `NoteEditorFoldScaleZoom`, `NoteEditorFoldScaleScroll`	Note editor view state.†
`IsInKey`, `NoteSpellingPreference`, `PreferFlatRootNote`	Scale settings.†

Loop

Element	Meaning
`LoopStart`	Loop start, in beats.
`LoopEnd`	Loop end, in beats. The clip length that converters read.
`StartRelative`	Offset of the playback start.
`LoopOn`	Whether the clip loops.
`OutMarker`	The end marker.
`HiddenLoopStart`, `HiddenLoopEnd`	The loop settings remembered while looping is off.

Notes

Notes are grouped by pitch. Notes/KeyTracks holds one KeyTrack per MIDI note number in use: the KeyTrack has an Id, its MidiKey@Value gives the pitch (0 to 127), and its own Notes element holds the events.

Each event is a MidiNoteEvent; one published note writes the element as MidiNote.

Attribute	Type	Meaning
`Time`	real	Note start, in beats from the clip start.
`Duration`	real	Note length in beats.
`Velocity`	integer	Velocity, 0 to 127.
`VelocityDeviation`†	integer	Range of random change in velocity.
`OffVelocity`	integer	Release velocity.
`Probability`†	real	Chance of the note playing.
`IsEnabled`	boolean	Whether the note is active.
`NoteId`	integer	The note’s identifier within the clip.

<KeyTrack Id="0">
  <Notes>
    <MidiNoteEvent Time="0" Duration="0.25" Velocity="100" OffVelocity="64"
                   IsEnabled="true" NoteId="1" />
  </Notes>
  <MidiKey Value="60" />
</KeyTrack>

One quarter-beat middle C at the start of a clip.

AudioClip

An AudioClip has Id, Time, LomId, Duration and Loop as a MIDI clip does, a WarpMarkers element whose fields are not documented publicly, and a SampleRef that names its sample file.

SampleRef and FileRef

Audio is not stored in the set. SampleRef points to a file through FileRef, and describes the file so Live can find it again.

Newer sets use these elements:

Element	Meaning
`FileRef/RelativePath`	The path relative to the project.
`FileRef/Path`	The absolute path.
`FileRef/RelativePathType`	What the relative path is relative to; values are not documented.
`FileRef/Type`	The kind of reference; values are not documented.
`FileRef/LivePackName`, `FileRef/LivePackId`	The Live Pack the sample came from.
`FileRef/OriginalFileSize`, `FileRef/OriginalCrc`	Size and checksum, used to confirm a found file is the right one.
`LastModDate`	Modification time recorded for the file.
`SourceContext`, `SampleUsageHint`	Where the sample came from, and how it is used.
`DefaultDuration`, `DefaultSampleRate`	The sample’s length and rate.

An older form, in one published example, has FileRef/Name@Value, FileRef/Type@Value and a Data element of RelativePathElement items whose Dir attributes spell out the path one folder at a time.

Not confirmed

Names marked † are inferred from PyAbleton’s Python attribute names.
The fields inside WarpMarkers, and the values of FileRef/Type and RelativePathType.
Which Live version moved FileRef from path elements to RelativePath and Path.