ableton-js 3.3.5 → 3.4.1

package/CHANGELOG.md

@@ -4,8 +4,23 @@ 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.1](https://github.com/leolabs/ableton.js/compare/v3.4.0...v3.4.1)
+
+- :sparkles: Add a `safeStartPlaying` method that only calls `start_playing` when Live is currently stopped [`46e1354`](https://github.com/leolabs/ableton.js/commit/46e13549f0c33ef6d82d20c42df30fb8c539af32)
+- :bug: Fix master track erroring because it doesn't have solo/mute properties [`3b58e72`](https://github.com/leolabs/ableton.js/commit/3b58e7205a5e547b7e0f2e0784eb9be71548ce1c)
+- :mute: Don't log results of getting track view properties [`3b4a5bd`](https://github.com/leolabs/ableton.js/commit/3b4a5bd07c3be7b7ec9f2cc21574b72d1fb375b4)
+
+#### [v3.4.0](https://github.com/leolabs/ableton.js/compare/v3.3.5...v3.4.0)
+
+> 11 November 2023
+
+- :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)
 

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):
@@ -64,6 +95,21 @@ 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_start_playing(self, ns):
+        if not self.song.is_playing:
+            self.song.start_playing()
+            return True
+
+        return False
+
     def safe_stop_playing(self, ns):
         if self.song.is_playing:
             self.song.stop_playing()

package/midi-script/Track.py

@@ -14,9 +14,25 @@ class Track(Interface):
             return None
 
         track_id = Interface.save_obj(track)
+
+        solo = False
+        mute = False
+
+        try:
+            solo = track.solo
+        except:
+            pass
+
+        try:
+            mute = track.mute
+        except:
+            pass
+
         return {
             "id": track_id,
             "name": track.name,
+            "solo": solo,
+            "mute": mute,
             "color": track.color,
             "color_index": track.color_index,
             "is_foldable": track.is_foldable,

package/midi-script/version.py

@@ -1 +1 @@
-version = "3.3.5"
+version = "3.4.1"

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",
@@ -211,7 +211,22 @@ export declare class Song extends Namespace<GettableProperties, TransformedPrope
     startPlaying(): Promise<any>;
     stopAllClips(): Promise<any>;
     stopPlaying(): Promise<any>;
-    safeStopPlaying(): Promise<any>;
+    /**
+     * Only starts playing when Live is currently not playing
+     * to prevent Live from jumping back to the start when it's
+     * already playing.
+     *
+     * @returns a boolean indicating whether the command was executed
+     */
+    safeStartPlaying(): Promise<boolean>;
+    /**
+     * Only stops playback when Live is currently playing to prevent
+     * Live jumping back to the beginning of the arrangement when it's
+     * already stopped.
+     *
+     * @returns a boolean indicating whether the command was executed
+     */
+    safeStopPlaying(): Promise<boolean>;
     tapTempo(): Promise<any>;
     undo(): 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) {
@@ -147,6 +147,23 @@ class Song extends _1.Namespace {
     async stopPlaying() {
         return this.sendCommand("stop_playing");
     }
+    /**
+     * Only starts playing when Live is currently not playing
+     * to prevent Live from jumping back to the start when it's
+     * already playing.
+     *
+     * @returns a boolean indicating whether the command was executed
+     */
+    async safeStartPlaying() {
+        return this.sendCommand("safe_start_playing");
+    }
+    /**
+     * Only stops playback when Live is currently playing to prevent
+     * Live jumping back to the beginning of the arrangement when it's
+     * already stopped.
+     *
+     * @returns a boolean indicating whether the command was executed
+     */
     async safeStopPlaying() {
         return this.sendCommand("safe_stop_playing");
     }

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.5",
+  "version": "3.4.1",
   "description": "Control Ableton Live from Node",
   "main": "index.js",
   "author": "Leo Bernard <admin@leolabs.org>",