Skip to main content

Changelog

All notable changes to this project will be documented in this file. See standard-version for commit guidelines.

4.0.0 (2025-05-08)​

Features​

  • add changePan() methods to relatively change PAN values (a75a65e)

Other​

  • rename pan() to setPan() (c98d734)

BREAKING CHANGES​

The pan() method has been renamed to setPan() to align with the new changePan() method.

3.2.0 (2025-01-23)​

Features​

  • add type guard utilities for channel types (091b566)

3.1.0 (2025-01-01)​

Features​

  • add name$ property to FadeableChannel (5939eb2)
  • add support for channel sync (fdd6139)
  • wait for initial params after connection init (73725b2)

Other​

  • add contribution section on index page (fb65dd8)
  • add page "How this library works" (1652887)
  • add quick start guide (e57d73b)
  • add section about usage with async/await (347be1d)
  • add sponsor link in docs footer (99aff47)
  • add tests for MixerStore (1dbaa82)
  • disable Nx legacy cache (b7c5440)
  • nx migrate 20.1.4 (f616e2d)
  • nx migrate, use Angular 19 (cbcd58a)
  • prettier ignore all HTML files (7e5182e)
  • testbed: migrate styles to @use and remove lighten() (c7cfc81)
  • testbed: remove ngClass and migrate to [class] (1a041f5)

3.0.0 (2024-11-03)​

This release integrates another WebSocket abstraction. It also makes it possible to define an individual WebSocket constructor. Since we are not aware of potential edge cases and hidden breaking changes, this is published as a major release.

Features​

  • add options to SoundcraftUI, make WS ctor configurable (6510bfc)

Other​

  • move serializer function to WS creation (cba0fcc)
  • set useDefineForClassFields explicitly to false (d99b5e1)
  • use modern-isomorphic-ws for WebSocket (d9c9171)
  • add changelog to docs (aeae426)
  • rename workflow (1acba84)
  • add badges for CI and license (e3d96e5)
  • add badges in main README too (260b266)
  • fix README shields. again. (19ecf9a)
  • reformat changelog (2468177)
  • nx migrate 20.0.6 (611c84b)

2.7.0 (2024-10-22)​

Features​

  • add FxBus to ObjectStore (b929038)
  • add support for changing channel name (2f04098)
  • add support for FX parameters (3099b64)

Bug Fixes​

  • correct behavior when reading channel name (5546ee9)
  • remove unused function reference (d20caa7)

Other​

  • adjust BPM range (517a3f2)
  • broader typing for selectGenericChannelProperty (079ba6b)
  • fix dependency conflicts (3568b6a)
  • nx update to 20.0.2 (c8a5252)
  • rename ChannelStore to ObjectStore (a6aa8c7)
  • restructure command tables and add more info (dff0b86)
  • update ESLint and remove deprecated rule (0312d3f)

2.6.0 (2024-10-18)​

Features​

  • add support for FX BPM and type settings (140b25b)
  • add support for saving/updating cues (0da073f)
  • docs page with Docusaurus (13d8360)

Bug Fixes​

  • do not update current snapshot/cue when info is missing (ebf4071)

Other​

  • add docs page to package.json (00b3348)
  • add imprint and legal info (85a7c49)
  • remove path filter for CI build (bb63ccf)
  • rename AUX/FX buses to "sends" to align with the web app (1030f62)

2.5.0 (2024-09-14)​

Features​

  • add support for saving/updating snapshots (26d50d7)

Other​

  • nx update to 19.7.3 (1d1acb0)
  • remove unused imports (90b3855)
  • testbed: migrate inputs/outputs to signal functions (f09bafe)

2.4.1 (2024-09-09)​

Bug Fixes​

Other​

  • copy README to build output (946d035)

2.4.0 (2024-09-09)​

This is a huge release as it adds a brand new feature: VU meter! You can now consume the volume levels of all channels on the master bus. See the README for more information.

Features​

  • add support for VU meter (a764ceb)
  • vu: add utility function vuValueToDB() for conversion to dB values (cff10be)

Other​

  • add tests for ChannelStore and channel singletons (44ea734)
  • fix dependency conflicts (48b4543)
  • mark class fields as readonly (e247e1b)
  • minor docs/comment improvements (d09bca5)
  • nx update to 19.6 (1613c97)
  • nx update to 19.6.5 (e21b186)
  • remove unnecessary type guard and use faster comparison in filter() (695556e)
  • rename "util" to "utils" (e2fcc06)

2.3.0 (2024-07-30)​

Features​

  • add start and stop for dual-track recording (ab69511)
  • add start and stop for multi-track recording (#135) (be50bbd)
  • add support for multi-track channel selection (d5256bb)

Bug Fixes​

Other​

2.2.1 (2024-02-12)​

Bug Fixes​

  • remove unnecessary console.log (4c82f52)

2.2.0 (2024-02-12)​

Features​

  • expose connection status as value (1ad0c60)
  • testbed: add custom title strategy (ce74836)

Other​

  • nx migrate to 17 and Angular 17 (caf4695)
  • nx update 18 (364cd68)
  • reconnect to nx cloud (dc8442f)
  • remove unnecessary type declaration (c8550ab)
  • setup nx-cloud connection again (af00913)
  • testbed: add route titles (0ec666e)
  • testbed: align structure with current Angular project structure (a134163)
  • testbed: use Angular control flow (db7356f)
  • testbed: use method for connection (2dc017e)
  • update nx cloud workflow (fd6e615)

2.1.0 (2023-10-15)​

Features​

  • add support for automix (c2fa5e7)

Bug Fixes​

  • fix ESLint execution with Nx package (94aeb19)

Other​

  • nx migrate to 16.8 (aeda5d9)
  • nx update to 16.10 (fc27778)
  • player track selection (63bec3a)
  • rename function to linearMappingValueToRange (738b436)

2.0.1 (2023-05-23)​

Bug Fixes​

  • do not bundle WebSocket implementation (3380078)

Other​

  • add NPM OTP to publish script (b399ba6)

2.0.0 (2023-05-23)​

This release adds no new functionality and no API surface changes. However, since we changed the build and bundling process, it could break existing integrations.

  • enable strict TS settings and fix code (f08fc1b)
  • nx migrate to 16.1 and Angular 16 (d685d33)
  • testbed: rename comp selectors, use self-closing tags (95cbd94)
  • use Vite for bundling (0e3b119)

1.5.0 (2023-03-23)​

Features​

  • add support for MTK soundcheck (8aefb5a)

Other​

1.4.0 (2023-02-08)​

Features​

  • allow changing fader levels from -Infinity dB (6afc45b)
  • restrict pan values to range of 0..1 (65b7e88)

Other​

  • add explanation for deviceinfo.model (276471f)
  • change list symbol in CHANGELOG file (70ada4d)
  • exclude commit and tag from release process (2d002e7)

1.3.0 (2023-01-22)​

Features​

  • add device info with mixer model (08315c5)
  • differentiate between mixer models for HW channels (7d95c1f)
  • export all facade types in barrel (f07afc4)
  • testbed: add opening page for connection (7e7eec9)

Other​

  • nx migrate to 15.5 (05cc00d)
  • remove unused imports and non-necessary types (ca151f2)
  • setup CI with Nx Cloud (6ac0ef4)
  • testbed: correctly setup ESLint (1261807)

1.2.0 (2022-12-28)​

Features​

  • add multitrack busy state (3e0fb3c)
  • add support for gain control on HW channels (c064ab3)

Other​

  • create FUNDING.yml (aa59c96)
  • move dB calculation and benckmark to separate files (2a8dd5d)

1.1.1 (2022-12-22)​

Bug Fixes​

  • add isomorphic-ws as dependency in lib pjson (9b91341)

1.1.0 (2022-12-22)​

Features​

  • add support for multitrack recording on Ui24R (889ad2b)

Other​

  • add NPM badge to main README (6f6e468)
  • emit all commit types to changelog (a82c6a6)
  • explicitly set useDefineForClassfields to false (a7f66a7)
  • testbed: migrate Angular app to full standalone app (ce7d58e)

1.0.0 (2022-12-15)​

This is the greatest release ever – and also the first published major version! 🎉 This library is considered as stable after a long period of testing in production. A few things have been refactored, compared to the last version 0.11.0. Please be aware of possible breaking changes. Enjoy the lib and keep on producing! 🎚️🎶

Breaking Changes​

  • The state$ property on MixerStore now contains a flat object, see 203cda0.
  • Connection and fadeTo methods now return a promise. You can simply ignore this but it's a change in the public API. See 83e84bb and d48902a.

Features​

  • add mutegroups to channel store (9c58b66)
  • add support for channel delay (465cbfb)
  • add support for channel name (51062a3)
  • add support for relative delay changes (db99c01)
  • publish current show/snapshot/cue (0561108)
  • restrict fader level values to allowed range (cda38ce)
  • return Promise for connection methods (83e84bb)
  • return promise for fadeTo and fadeToDB (d48902a)
  • testbed: use input event instead of change (32b184a)

Refactoring​

  • refactor: store state as flat object instead of nested structure (203cda0)
  • refactor: channel store can hold any kind of object (445776d)
  • refactor: remove simple raw value selectors (f585575)
  • refactor: remove redundant helper and MixerState refs (883bb8d)
  • refactor: rename offset arguments (f34e310)

Bug Fixes​

  • docs: fix missing word in README (4a2565d)
  • testbed: style fixes (58d67e6)

0.11.0 (2021-08-13)​

Features​

  • add support for phantom power (08c8fd5)

0.10.1 (2021-08-05)​

Features​

  • add support for loading shows, snapshots and cues (f2791fc)

0.10.0 (2021-08-05)​

Features​

  • add support for loading shows, snapshots and cues (f2791fc)

0.9.0 (2021-05-27)​

Features​

  • expose stream with raw SETD/SETS messages (824b1d7)

0.8.0 (2021-03-26)​

Features​

  • add volume control for SOLO and headphone bus (b22de2b), closes #51

0.7.1 (2020-12-23)​

Bug Fixes​

  • add "ws" as dependency in mixer-connection package.json (ea2a860), closes #48
  • docs: fix typo in README (2a30c9b)

0.7.0 (2020-12-01)​

Features​

  • add bitmask util functions (f4e44c2)
  • add player shuffle state and toggle (c817a13), closes #43
  • add support for 2-track USB recording (e834f76)
  • add support for MUTE groups (61b74f5), closes #42

Bug Fixes​

  • misused expect in outbound messages test (4f76913)
  • docs: spelling mistake: Easing => Easings (67bdae1)

0.6.0 (2020-11-15)​

Features​

  • add ChannelStore for object caching (2cab536), closes #33
  • add standard-version for changelog management (ea28a1d)
  • Stereo Link and rework of transitions (85c2277), closes #31 #32

Bug Fixes​

  • move rounding out of LUT lookup (a91097c), closes #39
  • use correct capping value for relative changes (d57a030)

0.5.1 (2020-11-07)​

Bug Fixes​

  • use correct import path for rxjs/webSocket (ec44c68)

0.5.0 (2020-11-07)​

Features​

  • add relative fader level changes (3e053ed), closes #9
  • add subscribable player infos (bb3bc0b), closes #7
  • add timed transitions for all channels (e4e5522), closes #10

Bug Fixes​

  • testbed: wrong method names (aaf0f21)

0.4.0 (2020-11-03)​

Features​

  • add PRE/POST toggle for send channels (1455b38)

Bug Fixes​

  • correct FX channel address (d27a6e7)

0.3.0 (2020-11-01)​

Features​

  • get and set fader values in dB (c069ac4)

0.2.1 (2020-11-01)​

Bug Fixes​

  • use isomorphic-ws for WebSocket abstraction across platforms (7dd3a1e)

0.2.0 (2020-11-01)​

Features​

  • testbed: add page for master level, pan and dim (5a909d2)
  • testbed: add player page (1d95dcc)
  • add first version of fully-featured browser testbed (647ad86), closes #20
  • PAN: only on Master and AUX channels, add setPan functionality (dd55aa6)
  • provide own implementation for object path utilities (f141719), closes #16

Bug Fixes​

  • resolve toggle bug (3e37ada), closes #6
  • update regex to be compatible with older environments (ce04c8f)
  • wrong index for post/postproc on AUX bus (ec8bce2)

0.1.0 (2020-10-30)​

Features​

  • add proper connection handling (8dc7e44), closes #13 #6
  • ui-testbed: make mixer IP configurable (97a473a), closes #15
  • add examples to testbed app (bb17bd4)
  • add first buttons to testbed application (fd16994)
  • add prototype for fluent command interface (a3f186a)
  • create mixer-connection lib (4090cb8)
  • create testbed application with Express (e8378dd)
  • implement a bunch of commands as fluent interface (58762c4)
  • reactive approach for accumulating and reading the mixer state (46a03da)
  • set up connection architecture (bad13d4)
  • set up Nx workspace (1ff8d55)