Repository navigation
Releases
Releases · vittorfp/ableton-mcp
v1.10.17-fork.1
- New:
configure_simpler. Turn a recording of your own into a playable instrument: replace a Simpler's sample with any audio file on disk (sample_path), and setplayback_mode("classic", "one-shot", "slicing"),retriggerandslicing_playback_mode. Loading a sample from the browser onto a MIDI track already creates a Simpler (classOriginalSimpler); Live renames the device and the track after the file, so later calls need the new names (the name guard refuses the old ones). - Remote Script 1.10.17: reinstall the script and restart Live. 111 tools, 1179 tests, run on a real Live 12 Lite.
v1.10.16-fork.1
Found by dumping Live's own API (1126 members across 33 object types) and crossing it with what the script uses (42%). Everything below was measured and run on a real Live 12.4 Lite.
- Devices by name:
insert_device(a native device at a chain position, no browser; Live Lite answers "not available" for EQ Eight and Glue Compressor),move_device(inside the chain or to another track),duplicate_device. Fixes the old "device reorder is not possible". - Key and scale:
get_song_scale,set_song_scale. Live does not raise for an unknown scale name: it falls back to Major, so the tool reads it back and puts the old scale back. - Scene tempo:
set_scene_tempo(a scene with its own tempo and time signature, or clear). - Grooves:
get_grooves,set_groove,set_clip_groove. Live's API cannot take a groove away from a clip (it refuses None). - Warp markers:
edit_warp_marker(add, move, remove) to line a recording up with the grid. The Live constructor isWarpMarker(seconds in the file, beat). - Clip copies:
duplicate_clip_loop(double a MIDI loop with its notes),copy_note_region(repeat a stretch, transposed),copy_clip_to_slot. get_device_parametersreturnsitems(the choices) for quantized parameters anddefaultfor the others;get_live_statusnames the features the edition lacks (Live Lite lacksnote_velocity_ranges_and_probabilities: a note'sprobabilitymay be stored but not played).- Remote Script 1.10.16: reinstall the script and restart Live. 110 tools, 1167 tests.
v1.10.15-fork.1
- One undo step per tool call. Every state-changing tool now runs between
Song.begin_undo_stepandend_undo_step. Measured on Live 12.4 Lite: without them Live merged every API edit into ONE undo step; with them three tool calls took three undos, each reverting exactly one, and three redos restored them. Tools that work in several ticks (create_locator,set_track_routing,set_device_routing) are not wrapped (a step left open across ticks would swallow the user's own edits); theundowarning says so. - New:
get_live_status. Version and edition, CPU average and peak, the performance impact of each track (heaviest first: find the plugin that makes it crackle), features the edition lacks, and any open dialog with its text. - New:
press_dialog_button(button_index, expected_message). Answers Live's modal dialogs. Live reports the dialog's text and how many buttons it has, not their labels; the "number of tracks is limited to 8" box has two and index 0 closes it. The Remote Script keeps answering while a dialog is open. - Remote Script 1.10.15: reinstall the script and restart Live. 97 tools, 1120 tests, run on a real Live 12 Lite.
v1.10.14-fork.1
- Fix:
delete_trackon a group track. Found on a real group in Live 12.4 Lite: deleting the members one by one failed on the last one ("Couldn't delete track.") and left the set half deleted. The group is now deleted first, which takes its members with it. If Live stops partway, the error says how many tracks are left and how to undo. Run on a real Live: a group with 3 members deleted in one call, and one undo brought all 7 tracks back (fork issue #5). - Fix:
get_tracks_overviewwith a group track (reading a group's monitoring state raises in Live); members show thegroupthey belong to. - Remote Script 1.10.14: reinstall the script and restart Live. 1105 tests.
v1.10.13-fork.1
move_arrangement_clipcan move or copy a clip to another track. Newto_track_indexandto_expected_name;new_start_timedefaults to the same beat. MIDI goes to a MIDI track and audio to an audio track (Live refuses a MIDI clip on an audio track, and the tool says so first). The clip keeps its length, content offset and notes; the preview lists what the destination loses. Measured on Live 12.4 Lite:Track.duplicate_clip_to_arrangementaccepts a clip of another track of the same kind.- Also run on the real Live in this pass:
undoandredowithconfirm=true(one undo reverted a track rename and a track creation together, and redo restored both, as the tool warns). - Remote Script 1.10.13: reinstall the script and restart Live. 1102 tests.
v1.10.12-fork.1
- Clip automation can now be any shape.
set_clip_envelopewrites REAL breakpoints (modelinear, the default; a fade is two points) instead of fine steps, and takesshape:sine,triangle,saw_up,saw_down,square,random_steps,random_smooth,curve, withperiodorcycles,min/maxin the parameter's own units,phase,points_per_cycle,duty,seed,exponentandinvert. Example:{"type": "sine", "period": 4, "min": -0.6, "max": 0.6}onpan. - What Live allows (measured on Live 12.4 Lite):
create_eventwith aLive.Envelope.EnvelopeEventmakes a breakpoint and Live draws straight lines between breakpoints. A zero-lengthinsert_stepis only a spike, and the Bezier control coefficients are ignored. So a sine ispoints_per_cyclebreakpoints per cycle: 16 is within 2% of the amplitude, 32 within 0.5%. A square holds (steps). rampstill works (same as linear);mode: "steps"still holds each value. Session clips only; a Session clip copied into the Arrangement keeps its automation.- Remote Script 1.10.12: reinstall the script and restart Live. 1094 tests, run on a real Live 12 Lite.
v1.10.11-fork.1
- New:
search_browser_items. Find instruments, effects, presets and samples by name instead of opening folders of 150+ items: every word of the query must appear in the item's name or in the folders below the category root. Results carry the uriload_instrument_or_effecttakes. Breadth first (a device comes before the presets inside it), with a time budget:truncatedsays when to narrow the query or the category. Idea from upstream ahujasid#97 (vanjaoljaca). - Checked on a real Live 12 Lite: about 300 to 2500 items a second; the Lite has no Wavetable, which the search says by finding nothing.
- Remote Script 1.10.11: reinstall the script and restart Live. 95 tools, 1065 tests.
v1.10.10-fork.1
- Device parameters on return tracks and the master.
get_track_info,get_device_parametersandset_device_parametertaketrack_type("track", "return", "master"). The reverb and delay on the returns can now be read and set; before, only regular tracks could. - New:
set_track_monitoring("in", "auto", "off");get_tracks_overviewnow shows each track's monitoring. - New:
duplicate_track(from upstream ahujasid#94, Luke Gimza): devices, clips and mixer, the copy placed right after the original. At Live Lite's 8-track limit Live refuses and nothing changes. - Remote Script 1.10.10: reinstall the script and restart Live. 94 tools, 1054 tests, run on a real Live 12 Lite.
v1.10.9-fork.1
- New: the note tools work on Arrangement MIDI clips.
get_clip_notes,get_clip_info,add_notes_to_clip,clear_notes_from_clip,remove_notes_from_clip,apply_note_modifications,quantize_clipandreplace_clip_notestake an optionalclip_start_time(the clip's start beat, asget_arrangement_clipsshows it) to use an Arrangement clip instead of a Session slot. Measured on Live 12.4 Lite: the note API accepts Arrangement MIDI clips (the claim that they are read-only for notes was wrong). - Note times are in the clip's content. A clip trimmed or split at its head keeps all its notes and starts playing at
start_marker, so a note before it is not heard. - Remote Script 1.10.9: reinstall the script and restart Live. 92 tools, 1035 tests, run on a real Live 12 Lite.
v1.10.8-fork.1
- New:
get_tracks_overview(adapted from upstream ahujasid#110, M4x28): every track, return and the master in one compact read (kind, devices, volume and pan as Live shows them, mute/solo/arm, clip counts, group, colour, plus tempo, scenes and cue points). - New:
check_arrangement_sync(from ahujasid#110): per track, clips that start or end off a grid you choose (4 beats = bars by default), overlaps and gaps. Read-only; useful after trimming, splitting or moving clips. - New:
replace_clip_notes(from ahujasid#119, mateogon): swap all the notes of a Session MIDI clip for new ones. Validated before anything is removed, a note that would never play is an error, the old notes are put back if the write fails; preview by default. - New:
set_color(from ahujasid#99, Zachary May): colour of a track, a Session clip or a scene (palette 0-69), one tool. create_volume_fadefrom ahujasid#110 is not ported:set_clip_envelopein ramp mode already writes a fade.- Remote Script 1.10.8: reinstall the script and restart Live. 92 tools, 1022 tests, run on a real Live 12 Lite.