Paul
March 17, 2026, 4:16pm
21
Hi Brad,
Does that mean a new end point (e.g. ‘SetLists’ ) with such a method like ‘loadSetlistByName(name)’ and a property like ‘items’ giving all setlist names in the configured folder?
That would be awesome.
Another feature i have on my list is ‘Global Transpose’. How can i control that? Do I need to use ‘commands’ end point or are there other ways?
Paul
brad
March 17, 2026, 11:46pm
22
I’ve updated the set list endpoint with two new methods:
Using JS api:
console.log(await C.setList.available());
will produce
[
"list1",
"list2",
"subfolder/list3",
]
and load a set list like this:
C.setList.loadSetList("subfolder/list3")
Available now in build 4339 and latest jsapi
1 Like
Paul
March 18, 2026, 12:12am
23
Awesome. Thank you.
Will evaluate this. Probably next week, as i’m currently migrating my code to TypeScript.
brad
March 19, 2026, 2:27am
24
Hi Paul,
Just letting you know I’ve been modernizing cantabile-js a little. Specifically:
It’s now an ES6 module
The browser version has been renamed from cantabile-js.js to cantabile.js (and .min.js equivalents)
Version has been bumped v0.2
Lots of fixes to the jsdocs (and the online reference has been updated)
Now uses rollup for bundling (instead of browerify/uglify)
At the moment, it’s on a separate git branch v0.2
The v0.2 api should be considered unstable for the moment as I’m considering reworking it a bit and things might change/break.
See here for node and browser usage instructions.
Next version of Cantabile will include both the new and old versions and Cantabile’s WebUI will be updated to use the new version.
Brad
Paul
March 20, 2026, 9:30pm
25
Thank you for that information. Will evaluate the new module as well.
Do you intend to provide type declaration files for TypeScript developers?
Paul
Paul
March 23, 2026, 11:22pm
26
After wrapping my head around the asynchronous behaviour of that available() method, I got it working. Thanks again.
Paul
1 Like
Hi @Brad ,
I like the new API methods for setlist. I’m wondering about additional functionality for songs.
I would love the ability to:
load the list of songs in the Songs folder;
open (load) a song, by name. This would help in the ability to handle a song request.
Thank you - David
brad
March 27, 2026, 12:11am
28
Yes, that’s probably possible through a similar mechanism to what the set lists use. Leave it with me. (but ping me if you don’t hear back by next week sometime).
brad
April 7, 2026, 12:04am
29
Next build will have two similar methods on the song endpoint:
available() - returns an array of available song files
loadSong(name, state = null) - loads a song.
1 Like
Hi @Brad ,
Did you update the docs (Cantabile JavaScript API ) for these new methods? I couldn’t find them.
brad
April 10, 2026, 2:01am
31
Oops, forgot to push it up. Should be there now.
1 Like