Utility to monitor and control soundworks' shared states within Max.

Notes:

• This repository has been tested on Mac only, Windows version should work but is untested.

• Max
  • Install
  • Usage
  • Running the example
• Javascript
  • Install
  • Usage
• Caveats
• Development notes
  • Link Max package into Documents/Max 8/Packages
  • Running the test suite
  • How to open patcher?
• Credits
• License

1. Download the Max package (soundworks-max.zip) from the release :
   https://github.com/collective-soundworks/soundworks-max/releases
2. Unzip the package and copy the resulting directory in ~/Documents/Max 8/Packages
3. Open the helper patch for more informations

See the overview patch for more informations
cf. ~/Documents/Max 8/Packages/soundworks/extras/soundworks.maxpat

1. In the "overview" menu click soundworks.shared-state
2. Start the soundworks server by opening the soundworks.example.server
   and follow the instructions.

npm install --save @soundworks/max

In the src/server/index.js of your soundworks application, and configure the Max client:

import { Server } from '@soundworks/core/server.js';
// 1. Import the `configureMaxClient` function from the @soundworks/max package
import { configureMaxClient } from '@soundworks/max';
import { loadConfig } from '../utils/load-config.js';

// 2. Configure max client
const config = loadConfig(process.env.ENV, import.meta.url);
configureMaxClient(config);

const server = new Server(config);

Each soundworks.shared-state object creates a new soundworks client, which is known suboptimal, but improves user friendliness.

One of our unit test use 25 instances, which work on all systems without issues.
This test has been run with 100 objects successfully on ARM, but not on Intel.

ln -s .path/to/soundworks-max/max/soundworks ~/Documents/Max\ 8/Packages

Launching all the tests

npm test -- tests/**/*.spec.js

Launching only one test file

npm test -- tests/the-test/index.spec.js

For verbose output

VERBOSE=1 npm test -- tests/the-test/index.spec.js

CMD + OPTION + M then CMD + E then click on the button

https://soundworks.dev/credits.html

BSD-3-Clause