ableton-js 3.2.11 → 3.3.0

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.3.0](https://github.com/leolabs/ableton.js/compare/v3.2.11...v3.3.0)
+
+- Browsing and loading functionalities [`bc48c7c`](https://github.com/leolabs/ableton.js/commit/bc48c7c46c55c54baca42c58003865596370afe3)
+- :art: Improve formatting [`6e2e22b`](https://github.com/leolabs/ableton.js/commit/6e2e22b102cf560d39c07e60ae1afd7e2ecc851b)
+- :sparkles: Turn the browser into a singleton [`6d0152b`](https://github.com/leolabs/ableton.js/commit/6d0152b4610683460256951801ada08f8598abeb)
+
 #### [v3.2.11](https://github.com/leolabs/ableton.js/compare/v3.2.10...v3.2.11)
 
+> 15 July 2023
+
 - :loud_sound: Warn when the UDP tick is lagging or when processing UDP takes too long to finish [`c419afc`](https://github.com/leolabs/ableton.js/commit/c419afc96de5b5834ae2807baf8fc4b3fb9c21ba)
 - :sparkles: Use larger buffer sizes if possible for sending responses from Live [`ae480cb`](https://github.com/leolabs/ableton.js/commit/ae480cb6e86fcbbb4e0417b0869a5a78d43511c6)
 - :memo: Update docs to reflect that chunks now have a dynamic size [`83afbb6`](https://github.com/leolabs/ableton.js/commit/83afbb6431a28883fdc459e31081b94bd9c6b54a)

package/midi-script/AbletonJS.py

@@ -7,6 +7,8 @@ from .Socket import Socket
 from .Interface import Interface
 from .Application import Application
 from .ApplicationView import ApplicationView
+from .Browser import Browser
+from .BrowserItem import BrowserItem
 from .CuePoint import CuePoint
 from .Device import Device
 from .DeviceParameter import DeviceParameter
@@ -38,6 +40,8 @@ class AbletonJS(ControlSurface):
         self.handlers = {
             "application": Application(c_instance, self.socket, self.application()),
             "application-view": ApplicationView(c_instance, self.socket, self.application()),
+            "browser": Browser(c_instance, self.socket, self.application()),
+            "browser-item": BrowserItem(c_instance, self.socket),
             "cue-point": CuePoint(c_instance, self.socket),
             "device": Device(c_instance, self.socket),
             "device-parameter": DeviceParameter(c_instance, self.socket),

package/midi-script/Browser.py

@@ -0,0 +1,66 @@
+from __future__ import absolute_import
+from .Interface import Interface
+from .BrowserItem import BrowserItem
+
+
+class Browser(Interface):
+    def __init__(self, c_instance, socket, application):
+        super(Browser, self).__init__(c_instance, socket)
+        self.application = application
+
+    def get_ns(self, nsid=None):
+        return self.application.browser
+
+    def get_audio_effects(self, ns):
+        return map(BrowserItem.serialize_browser_item, ns.audio_effects.children)
+
+    def get_clips(self, ns):
+        return map(BrowserItem.serialize_browser_item, ns.clips.children)
+
+    def get_colors(self, ns):
+        return map(BrowserItem.serialize_browser_item, ns.colors)
+
+    def get_current_project(self, ns):
+        return map(BrowserItem.serialize_browser_item, ns.current_project.children)
+
+    def get_drums(self, ns):
+        return map(BrowserItem.serialize_browser_item, ns.drums.children)
+
+    def get_instruments(self, ns):
+        return map(BrowserItem.serialize_browser_item, ns.instruments.children)
+
+    def get_max_for_live(self, ns):
+        return map(BrowserItem.serialize_browser_item, ns.max_for_live.children)
+
+    def get_midi_effects(self, ns):
+        return map(BrowserItem.serialize_browser_item, ns.midi_effects.children)
+
+    def get_packs(self, ns):
+        return map(BrowserItem.serialize_browser_item, ns.packs.children)
+
+    def get_plugins(self, ns):
+        return map(BrowserItem.serialize_browser_item, ns.plugins.children)
+
+    def get_samples(self, ns):
+        return map(BrowserItem.serialize_browser_item, ns.samples.children)
+
+    def get_sounds(self, ns):
+        return map(BrowserItem.serialize_browser_item, ns.sounds.children)
+
+    def get_user_folders(self, ns):
+        return map(BrowserItem.serialize_browser_item, ns.user_folders)
+
+    def get_user_library(self, ns):
+        return map(BrowserItem.serialize_browser_item, ns.user_library.children)
+
+    def get_hotswap_target(self, ns):
+        return BrowserItem.serialize_browser_item(ns.hotswap_target)
+
+    def load_item(self, ns, id):
+        return ns.load_item(self.get_obj(id))
+
+    def preview_item(self, ns, id):
+        return ns.preview_item(self.get_obj(id))
+
+    def stop_preview(self, ns):
+        return ns.stop_preview()

package/midi-script/BrowserItem.py

@@ -0,0 +1,26 @@
+from __future__ import absolute_import
+from .Interface import Interface
+
+
+class BrowserItem(Interface):
+    @staticmethod
+    def serialize_browser_item(browser_item):
+        if browser_item is None:
+            return None
+        browser_item_id = Interface.save_obj(browser_item)
+        return {
+            "id": browser_item_id,
+            "name": browser_item.name,
+            "is_loadable": browser_item.is_loadable,
+            "is_selected": browser_item.is_selected,
+            "is_device": browser_item.is_device,
+            "is_folder": browser_item.is_folder,
+            "source": browser_item.source,
+            "uri": browser_item.uri,
+        }
+
+    def __init__(self, c_instance, socket):
+        super(BrowserItem, self).__init__(c_instance, socket)
+
+    def get_children(self, ns):
+        return map(BrowserItem.serialize_browser_item, ns.children)

package/midi-script/Song.py

@@ -4,12 +4,17 @@ from .CuePoint import CuePoint
 from .Device import Device
 from .Scene import Scene
 from .Track import Track
+import Live
 
+INSERT_MODES = {'default':Live.Track.DeviceInsertMode.default, 
+ 'left':Live.Track.DeviceInsertMode.selected_left, 
+ 'right':Live.Track.DeviceInsertMode.selected_right}
 
 class Song(Interface):
     def __init__(self, c_instance, socket):
         super(Song, self).__init__(c_instance, socket)
         self.song = self.ableton.song()
+        self._insert_mode = INSERT_MODES['default']
 
     def get_ns(self, nsid):
         return self.song
@@ -60,3 +65,7 @@ class Song(Interface):
 
     def set_appointed_device(self, ns, device_id):
         ns.appointed_device = Interface.get_obj(device_id)
+
+    def set_insert_mode(self,ns, args):
+        self._insert_mode = INSERT_MODES.get(str(args), INSERT_MODES['default'])
+        self.song.view.selected_track.view.device_insert_mode = self._insert_mode

package/midi-script/version.py

@@ -1 +1 @@
-version = "3.2.11"
+version = "3.3.0"

package/ns/application.d.ts

@@ -1,6 +1,7 @@
 import { Ableton } from "..";
 import { Namespace } from ".";
 import { ApplicationView } from "./application-view";
+import { Browser, RawBrowser } from "./browser";
 export interface GettableProperties {
     bugfix_version: number;
     major_version: number;
@@ -9,8 +10,10 @@ export interface GettableProperties {
     current_dialog_button_count: number;
     current_dialog_message: string;
     open_dialog_count: number;
+    browser: RawBrowser;
 }
 export interface TransformedProperties {
+    browser: Browser;
 }
 export interface SettableProperties {
 }
@@ -19,6 +22,7 @@ export interface ObservableProperties {
 }
 export declare class Application extends Namespace<GettableProperties, TransformedProperties, SettableProperties, ObservableProperties> {
     constructor(ableton: Ableton);
+    browser: Browser;
     view: ApplicationView;
     pressCurrentDialogButton(index: number): Promise<any>;
 }

package/ns/application.js

@@ -3,10 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Application = void 0;
 const _1 = require(".");
 const application_view_1 = require("./application-view");
+const browser_1 = require("./browser");
 class Application extends _1.Namespace {
     constructor(ableton) {
         super(ableton, "application");
     }
+    browser = new browser_1.Browser(this.ableton);
     view = new application_view_1.ApplicationView(this.ableton);
     async pressCurrentDialogButton(index) {
         return this.sendCommand("press_current_dialog_button", [index]);

package/ns/browser-item.d.ts

@@ -0,0 +1,34 @@
+import { Ableton } from "..";
+import { Namespace } from ".";
+export interface RawBrowserItem {
+    id: string;
+    children: RawBrowserItem[];
+    name: string;
+    is_loadable: boolean;
+    is_selected: boolean;
+    is_device: boolean;
+    is_folder: boolean;
+    source: string;
+    uri: string;
+}
+export interface GettableProperties {
+    children: RawBrowserItem[];
+    is_device: boolean;
+    is_folder: boolean;
+    is_loadable: boolean;
+    is_selected: boolean;
+    name: string;
+    source: string;
+    uri: string;
+}
+export interface TransformedProperties {
+    children: BrowserItem[];
+}
+export interface SettableProperties {
+}
+export interface ObservableProperties {
+}
+export declare class BrowserItem extends Namespace<GettableProperties, TransformedProperties, SettableProperties, ObservableProperties> {
+    raw: RawBrowserItem;
+    constructor(ableton: Ableton, raw: RawBrowserItem);
+}

package/ns/browser-item.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserItem = void 0;
+const _1 = require(".");
+class BrowserItem extends _1.Namespace {
+    raw;
+    constructor(ableton, raw) {
+        super(ableton, "browser-item", raw.id);
+        this.raw = raw;
+        this.transformers = {
+            children: (children) => children.map((c) => new BrowserItem(ableton, c)),
+        };
+        this.cachedProps = {
+            children: true,
+            is_device: true,
+            is_folder: true,
+            is_loadable: false,
+            is_selected: false,
+            name: true,
+            source: true,
+            uri: true,
+        };
+    }
+}
+exports.BrowserItem = BrowserItem;

package/ns/browser.d.ts

@@ -0,0 +1,55 @@
+import { Ableton } from "..";
+import { Namespace } from ".";
+import { BrowserItem, RawBrowserItem } from "./browser-item";
+export interface GettableProperties {
+    audio_effects: RawBrowserItem[];
+    clips: RawBrowserItem[];
+    colors: RawBrowserItem[];
+    current_project: RawBrowserItem[];
+    drums: RawBrowserItem[];
+    instruments: RawBrowserItem[];
+    max_for_live: RawBrowserItem[];
+    midi_effects: RawBrowserItem[];
+    packs: RawBrowserItem[];
+    plugins: RawBrowserItem[];
+    samples: RawBrowserItem[];
+    sounds: RawBrowserItem[];
+    user_library: RawBrowserItem[];
+    user_folders: RawBrowserItem[];
+    hotswap_target: RawBrowserItem;
+}
+export interface TransformedProperties {
+    audio_effects: BrowserItem[];
+    clips: BrowserItem[];
+    colors: BrowserItem[];
+    current_project: BrowserItem[];
+    drums: BrowserItem[];
+    instruments: BrowserItem[];
+    max_for_live: BrowserItem[];
+    midi_effects: BrowserItem[];
+    packs: BrowserItem[];
+    plugins: BrowserItem[];
+    samples: BrowserItem[];
+    sounds: BrowserItem[];
+    user_library: BrowserItem[];
+    user_folders: BrowserItem[];
+    hotswap_target: BrowserItem;
+}
+export interface SettableProperties {
+}
+export interface ObservableProperties {
+    filter_type: never;
+    hotswap_target: BrowserItem;
+}
+export interface RawBrowser {
+    id: string;
+}
+export declare class Browser extends Namespace<GettableProperties, TransformedProperties, SettableProperties, ObservableProperties> {
+    constructor(ableton: Ableton);
+    /** Loads the provided browser item. */
+    loadItem(item: BrowserItem): Promise<any>;
+    /** Previews the provided browser item. */
+    previewItem(item: BrowserItem): Promise<any>;
+    /** Stops the current preview. */
+    stopPreview(): Promise<any>;
+}

package/ns/browser.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Browser = void 0;
+const _1 = require(".");
+const browser_item_1 = require("./browser-item");
+class Browser extends _1.Namespace {
+    constructor(ableton) {
+        super(ableton, "browser");
+        const makeBrowserItems = (items) => items.map((item) => new browser_item_1.BrowserItem(ableton, item));
+        this.transformers = {
+            audio_effects: makeBrowserItems,
+            clips: makeBrowserItems,
+            colors: makeBrowserItems,
+            current_project: makeBrowserItems,
+            drums: makeBrowserItems,
+            instruments: makeBrowserItems,
+            max_for_live: makeBrowserItems,
+            midi_effects: makeBrowserItems,
+            packs: makeBrowserItems,
+            plugins: makeBrowserItems,
+            samples: makeBrowserItems,
+            sounds: makeBrowserItems,
+            user_library: makeBrowserItems,
+            user_folders: makeBrowserItems,
+            hotswap_target: (t) => new browser_item_1.BrowserItem(ableton, t),
+        };
+        this.cachedProps = {
+            audio_effects: true,
+            clips: true,
+            colors: true,
+            current_project: true,
+            drums: true,
+            instruments: true,
+            max_for_live: true,
+            midi_effects: true,
+            packs: true,
+            plugins: true,
+            samples: true,
+            sounds: true,
+            user_library: true,
+            user_folders: true,
+            hotswap_target: true,
+        };
+    }
+    /** Loads the provided browser item. */
+    async loadItem(item) {
+        return this.sendCommand("load_item", { id: item.raw.id });
+    }
+    /** Previews the provided browser item. */
+    async previewItem(item) {
+        return this.sendCommand("preview_item", { id: item.raw.id });
+    }
+    /** Stops the current preview. */
+    async stopPreview() {
+        return this.sendCommand("stop_preview");
+    }
+}
+exports.Browser = Browser;

package/ns/song.d.ts

@@ -61,6 +61,11 @@ export interface TransformedProperties {
     visible_tracks: Track[];
     scenes: Scene[];
 }
+export declare enum DeviceInsertMode {
+    default = "default",
+    left = "left",
+    right = "right"
+}
 export interface SettableProperties {
     appointed_device: string;
     arrangement_overdub: boolean;
@@ -71,6 +76,7 @@ export interface SettableProperties {
     exclusive_arm: number;
     exclusive_solo: number;
     groove_amount: number;
+    insert_mode: DeviceInsertMode;
     is_counting_in: boolean;
     is_playing: boolean;
     last_event_time: number;
@@ -213,4 +219,5 @@ export declare class Song extends Namespace<GettableProperties, TransformedPrope
     stopPlaying(): Promise<any>;
     tapTempo(): Promise<any>;
     undo(): Promise<any>;
+    set_insert_mode(args: DeviceInsertMode): Promise<any>;
 }

package/ns/song.js

@@ -1,11 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Song = exports.RecordingQuantization = exports.Quantization = exports.TimeFormat = void 0;
+exports.Song = exports.RecordingQuantization = exports.Quantization = exports.TimeFormat = exports.DeviceInsertMode = void 0;
 const _1 = require(".");
 const track_1 = require("./track");
 const cue_point_1 = require("./cue-point");
 const song_view_1 = require("./song-view");
 const scene_1 = require("./scene");
+var DeviceInsertMode;
+(function (DeviceInsertMode) {
+    DeviceInsertMode["default"] = "default";
+    DeviceInsertMode["left"] = "left";
+    DeviceInsertMode["right"] = "right";
+})(DeviceInsertMode || (exports.DeviceInsertMode = DeviceInsertMode = {}));
 var TimeFormat;
 (function (TimeFormat) {
     TimeFormat[TimeFormat["MsTime"] = 0] = "MsTime";
@@ -149,5 +155,8 @@ class Song extends _1.Namespace {
     async undo() {
         return this.sendCommand("undo");
     }
+    async set_insert_mode(args) {
+        return this.sendCommand("set_insert_mode", { args });
+    }
 }
 exports.Song = Song;

package/package.json

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