ableton-js 3.4.0 → 3.4.1

package/CHANGELOG.md

@@ -4,8 +4,16 @@ 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)
 

package/midi-script/Song.py

@@ -103,6 +103,13 @@ class Song(Interface):
         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,11 +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": track.solo,
-            "mute": track.mute,
+            "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.4.0"
+version = "3.4.1"

package/ns/song.d.ts

@@ -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

@@ -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/package.json

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