ableton-js 3.3.4 → 3.4.0

package/CHANGELOG.md

@@ -4,8 +4,22 @@ All notable changes to this project will be documented in this file. Dates are d
 
 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
+#### [v3.4.0](https://github.com/leolabs/ableton.js/compare/v3.3.5...v3.4.0)
+
+- :bug: Fix setting quantizations not working correctly [`cd7a6e5`](https://github.com/leolabs/ableton.js/commit/cd7a6e52e65ad8dea9082b8b24afed952f6b33ad)
+- :sparkles: Return mute and solo properties for each track [`5585533`](https://github.com/leolabs/ableton.js/commit/558553386dc7a0927541c2b246cc27fd86677641)
+
+#### [v3.3.5](https://github.com/leolabs/ableton.js/compare/v3.3.4...v3.3.5)
+
+> 6 November 2023
+
+- :sparkles: Properly create and return scenes and tracks [`dc550f1`](https://github.com/leolabs/ableton.js/commit/dc550f15a79360caf3b247f5373a1d255b2b3476)
+- :bug: Fix `createScene` not working when no index is provided [`e6bf99b`](https://github.com/leolabs/ableton.js/commit/e6bf99b7bcbcc053a2cddd12b5a77d91f36b0430)
+
 #### [v3.3.4](https://github.com/leolabs/ableton.js/compare/v3.3.3...v3.3.4)
 
+> 26 October 2023
+
 - :sparkles: Add support for the Track View class [`3ff5980`](https://github.com/leolabs/ableton.js/commit/3ff5980e5e5f407bc6b767a5329b54774ca10534)
 - :sparkles: Add a `safeStopPlaying` function that only stops playback when Live is currently playing to prevent accidental jumps to the beginning of the timeline [`a7b84e2`](https://github.com/leolabs/ableton.js/commit/a7b84e2146a69ab00cc75f83a4eedd5d91495eda)
 - :art: Fix formatting [`f06d3d0`](https://github.com/leolabs/ableton.js/commit/f06d3d0cde4632612b1db8ea04e85f1276eb8bb6)

package/midi-script/Song.py

@@ -5,6 +5,37 @@ from .Device import Device
 from .Scene import Scene
 from .Track import Track
 
+import Live
+
+PLAY_QUANTIZATIONS = {
+    'q_8_bars': Live.Song.Quantization.q_8_bars,
+    'q_4_bars': Live.Song.Quantization.q_4_bars,
+    'q_2_bars': Live.Song.Quantization.q_2_bars,
+    'q_bar': Live.Song.Quantization.q_bar,
+    'q_half': Live.Song.Quantization.q_half,
+    'q_half_triplet': Live.Song.Quantization.q_half_triplet,
+    'q_quarter': Live.Song.Quantization.q_quarter,
+    'q_quarter_triplet': Live.Song.Quantization.q_quarter_triplet,
+    'q_eight': Live.Song.Quantization.q_eight,
+    'q_eight_triplet': Live.Song.Quantization.q_eight_triplet,
+    'q_sixtenth': Live.Song.Quantization.q_sixtenth,
+    'q_sixtenth_triplet': Live.Song.Quantization.q_sixtenth_triplet,
+    'q_thirtytwoth': Live.Song.Quantization.q_thirtytwoth,
+    'q_no_q': Live.Song.Quantization.q_no_q
+}
+
+REC_QUANTIZATIONS = {
+    'rec_q_eight': Live.Song.RecordingQuantization.rec_q_eight,
+    'rec_q_eight_eight_triplet': Live.Song.RecordingQuantization.rec_q_eight_eight_triplet,
+    'rec_q_eight_triplet': Live.Song.RecordingQuantization.rec_q_eight_triplet,
+    'rec_q_no_q': Live.Song.RecordingQuantization.rec_q_no_q,
+    'rec_q_quarter': Live.Song.RecordingQuantization.rec_q_quarter,
+    'rec_q_sixtenth': Live.Song.RecordingQuantization.rec_q_sixtenth,
+    'rec_q_sixtenth_sixtenth_triplet': Live.Song.RecordingQuantization.rec_q_sixtenth_sixtenth_triplet,
+    'rec_q_sixtenth_triplet': Live.Song.RecordingQuantization.rec_q_sixtenth_triplet,
+    'rec_q_thirtysecond': Live.Song.RecordingQuantization.rec_q_thirtysecond,
+}
+
 
 class Song(Interface):
     def __init__(self, c_instance, socket):
@@ -23,6 +54,9 @@ class Song(Interface):
     def create_return_track(self, ns):
         return Track.serialize_track(ns.create_return_track())
 
+    def create_scene(self, ns, index):
+        return Scene.serialize_scene(ns.create_scene(index))
+
     def get_clip_trigger_quantization(self, ns):
         return str(ns.clip_trigger_quantization)
 
@@ -61,6 +95,14 @@ class Song(Interface):
     def set_appointed_device(self, ns, device_id):
         ns.appointed_device = Interface.get_obj(device_id)
 
+    def set_clip_trigger_quantization(self, ns, name):
+        quantization = PLAY_QUANTIZATIONS.get(str(name), PLAY_QUANTIZATIONS['q_bar'])
+        ns.clip_trigger_quantization = quantization
+
+    def set_midi_recording_quantization(self, ns, name):
+        quantization = REC_QUANTIZATIONS.get(str(name), REC_QUANTIZATIONS['rec_q_no_q'])
+        ns.midi_recording_quantization = quantization
+
     def safe_stop_playing(self, ns):
         if self.song.is_playing:
             self.song.stop_playing()

package/midi-script/Track.py

@@ -17,6 +17,8 @@ class Track(Interface):
         return {
             "id": track_id,
             "name": track.name,
+            "solo": track.solo,
+            "mute": track.mute,
             "color": track.color,
             "color_index": track.color_index,
             "is_foldable": track.is_foldable,

package/midi-script/version.py

@@ -1 +1 @@
-version = "3.3.4"
+version = "3.4.0"

package/ns/scene.d.ts

@@ -1,6 +1,7 @@
 import { Ableton } from "..";
 import { Namespace } from ".";
 import { ClipSlot, RawClipSlot } from "./clip-slot";
+import { Color } from "../util/color";
 export interface GettableProperties {
     clip_slots: RawClipSlot[];
     color: number;
@@ -11,6 +12,7 @@ export interface GettableProperties {
     tempo: number;
 }
 export interface TransformedProperties {
+    color: Color;
     clip_slots: ClipSlot[];
 }
 export interface SettableProperties {

package/ns/scene.js

@@ -3,12 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Scene = void 0;
 const _1 = require(".");
 const clip_slot_1 = require("./clip-slot");
+const color_1 = require("../util/color");
 class Scene extends _1.Namespace {
     raw;
     constructor(ableton, raw) {
         super(ableton, "scene", raw.id);
         this.raw = raw;
         this.transformers = {
+            color: (c) => new color_1.Color(c),
             clip_slots: (clip_slots) => clip_slots.map((c) => new clip_slot_1.ClipSlot(this.ableton, c)),
         };
         this.cachedProps = {

package/ns/song.d.ts

@@ -156,20 +156,20 @@ export declare enum TimeFormat {
     Smpte30Drop = 5
 }
 export declare enum Quantization {
-    q_2_bars = "q_2_bars",
-    q_4_bars = "q_4_bars",
     q_8_bars = "q_8_bars",
+    q_4_bars = "q_4_bars",
+    q_2_bars = "q_2_bars",
     q_bar = "q_bar",
-    q_eight = "q_eight",
-    q_eight_triplet = "q_eight_triplet",
     q_half = "q_half",
     q_half_triplet = "q_half_triplet",
-    q_no_q = "q_no_q",
     q_quarter = "q_quarter",
     q_quarter_triplet = "q_quarter_triplet",
+    q_eight = "q_eight",
+    q_eight_triplet = "q_eight_triplet",
     q_sixtenth = "q_sixtenth",
     q_sixtenth_triplet = "q_sixtenth_triplet",
-    q_thirtytwoth = "q_thirtytwoth"
+    q_thirtytwoth = "q_thirtytwoth",
+    q_no_q = "q_no_q"
 }
 export declare enum RecordingQuantization {
     rec_q_eight = "rec_q_eight",
@@ -187,10 +187,10 @@ export declare class Song extends Namespace<GettableProperties, TransformedPrope
     view: SongView;
     beginUndoStep(): Promise<any>;
     continuePlaying(): Promise<any>;
-    createAudioTrack(index?: number): Promise<any>;
-    createMidiTrack(index?: number): Promise<any>;
-    createReturnTrack(): Promise<any>;
-    createScene(index?: number): Promise<any>;
+    createAudioTrack(index?: number): Promise<Track>;
+    createMidiTrack(index?: number): Promise<Track>;
+    createReturnTrack(): Promise<Track>;
+    createScene(index?: number): Promise<Scene>;
     deleteReturnTrack(index: number): Promise<any>;
     deleteScene(index: number): Promise<any>;
     deleteTrack(index: number): Promise<any>;

package/ns/song.js

@@ -17,20 +17,20 @@ var TimeFormat;
 })(TimeFormat || (exports.TimeFormat = TimeFormat = {}));
 var Quantization;
 (function (Quantization) {
-    Quantization["q_2_bars"] = "q_2_bars";
-    Quantization["q_4_bars"] = "q_4_bars";
     Quantization["q_8_bars"] = "q_8_bars";
+    Quantization["q_4_bars"] = "q_4_bars";
+    Quantization["q_2_bars"] = "q_2_bars";
     Quantization["q_bar"] = "q_bar";
-    Quantization["q_eight"] = "q_eight";
-    Quantization["q_eight_triplet"] = "q_eight_triplet";
     Quantization["q_half"] = "q_half";
     Quantization["q_half_triplet"] = "q_half_triplet";
-    Quantization["q_no_q"] = "q_no_q";
     Quantization["q_quarter"] = "q_quarter";
     Quantization["q_quarter_triplet"] = "q_quarter_triplet";
+    Quantization["q_eight"] = "q_eight";
+    Quantization["q_eight_triplet"] = "q_eight_triplet";
     Quantization["q_sixtenth"] = "q_sixtenth";
     Quantization["q_sixtenth_triplet"] = "q_sixtenth_triplet";
     Quantization["q_thirtytwoth"] = "q_thirtytwoth";
+    Quantization["q_no_q"] = "q_no_q";
 })(Quantization || (exports.Quantization = Quantization = {}));
 var RecordingQuantization;
 (function (RecordingQuantization) {
@@ -71,17 +71,21 @@ class Song extends _1.Namespace {
     async continuePlaying() {
         return this.sendCommand("continue_playing");
     }
-    async createAudioTrack(index) {
-        return this.sendCommand("create_audio_track", { index });
+    async createAudioTrack(index = -1) {
+        const result = await this.sendCommand("create_audio_track", { index });
+        return new track_1.Track(this.ableton, result);
     }
-    async createMidiTrack(index) {
-        return this.sendCommand("create_midi_track", { index });
+    async createMidiTrack(index = -1) {
+        const result = await this.sendCommand("create_midi_track", { index });
+        return new track_1.Track(this.ableton, result);
     }
     async createReturnTrack() {
-        return this.sendCommand("create_return_track");
+        const result = await this.sendCommand("create_return_track");
+        return new track_1.Track(this.ableton, result);
     }
-    async createScene(index) {
-        return this.sendCommand("create_scene", [index]);
+    async createScene(index = -1) {
+        const result = await this.sendCommand("create_scene", { index });
+        return new scene_1.Scene(this.ableton, result);
     }
     async deleteReturnTrack(index) {
         return this.sendCommand("delete_return_track", [index]);

package/ns/track.d.ts

@@ -147,6 +147,8 @@ export interface RawTrack {
     color_index: number;
     is_foldable: boolean;
     is_grouped: boolean;
+    mute: boolean;
+    solo: boolean;
 }
 export declare class Track extends Namespace<GettableProperties, TransformedProperties, SettableProperties, ObservableProperties> {
     raw: RawTrack;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ableton-js",
-  "version": "3.3.4",
+  "version": "3.4.0",
   "description": "Control Ableton Live from Node",
   "main": "index.js",
   "author": "Leo Bernard <admin@leolabs.org>",