npm install soundmodelsWeb Audio based Sound Models for creating dynamic interactive sounds.
Sound Models are parameterized algorithms which generate dynamic sounds in real time.
Sound Models currently available:
Texture based models use some kind of audio source (mp3, wav audio files). The support for the various types of audio files is based on the browser being used. wav and mp3 are the most widely supported file formats. Here is a good guide for knowing which codecs are supported by which browser.
DecodeThis is a good tool to check if a file of specific codec, bitrate, sample rate is support by a specific browser.
##### Looper
Loops the audio source continuously. Also supports looping of multiple source synchronously.
##### Trigger
Triggers a single playback of the audio source. Supports multiple voices and multiple simulteanous playbacks.
##### MultiTrigger
Triggers a repeated playback of the audio source.
##### Activity
Change the playback speed on an audio source based on the rate of change of a parameter.
##### Scrubber
Allows for 'scrubbing' of the audio source by changing which part of the audio source is being played.
##### Extender
Extends an audio source inifinitely without making it feel repeated.
Coming soon...
Effects are connected to the output of these Sound Models to change some audio qualities of the Sound. Effects, just like Sound Models, also expose Parameters which can be used to control the effects in real time.
Effects currently available:
#### Fader
A simple Fader effect which allows the change of the volume (loudness) of the incoming audio.
#### Panner
A simple stereo Panner effect which allows moving of the perceived source of the audio towards the left or right side of the listener.
#### Filter
A simple low-order filters that can be used as a building blocks of basic tone controls (bass, mid, treble), graphic equalizers, and more advanced filters.
#### Compressor
Dynamics compression lowers the volume of the loudest parts of the signal and raises the volume of the softest parts. It can be used for produce, a louder, richer, and fuller sound.
#### Distorter
Distortion effect which tries to emulate a guitar amp distortion.
The sound models are available in two types of packages, CommonJS and AMD. The sound models are packed as UMD modules and hence usable directly as global variable as well.
Source files of the soundmodels are also available in the npm & bower packages to support libraries which are using soundmodels as a dependency. Using the source files will significantly reduced file footprint and is highly encouraged to use them rather than the compiled bundles. Use the compiled bundles if you are just requiring usage of one model in a browser environment via the
2. Also include the actual model file which you would like to use (for eg. Trigger.js).
3. You can then use the loaded Sound Model using RequireJS. (For now you have to use models/Looper or models/Trigger as the names of the requirements)
`js`
require(["models/Looper"], function (Looper) {
var loop = new Looper("loop.wav",function(){
console.log("Loaded!");
loop.play();
});
console.log("Loading Audio File...");
});
4. Detailed information about rest of the API can be found in the API docs for individual Sound Models.
The build process uses gulpjs
- ` gulp build`
A concatenated file per model is placed in the build directory.
- ` gulp test`
Generates a build and serves the test files in the test/manual directory.
- ` gulp unittest`
Generates a build and serves the unittest files in the test/unittest directory.
- `gulp publishdocs`
API documentation is compiled and placed in the docs/api directory.
The built Sound Models for the latest release are avaliable in the dist/models directory. Otherwise they can be installed using npm or bower.
Each Sound Model is packaged into a seperate UMD bundled JavaScript file (with all it's depencies bundled along). The individual files can be downloaded and added to your project, or could be linked straight from github (using the raw github URL) for testing. Refer to section on Usage for instructions on using the Models.
Here are the URLs for the currently supported Models.
| Model | URL |
| ------------- |:-------------:|
| Looper | https://github.com/Sonoport/soundmodels/blob/master/dist/models/Looper.js |
| Trigger | https://github.com/Sonoport/soundmodels/blob/master/dist/models/Trigger.js |
| MultiTrigger | https://github.com/Sonoport/soundmodels/blob/master/dist/models/MultiTrigger.js |
| Scrubber | https://github.com/Sonoport/soundmodels/blob/master/dist/models/Scrubber.js |
| Activity | https://github.com/Sonoport/soundmodels/blob/master/dist/models/Activity.js |
| Extender | https://github.com/Sonoport/soundmodels/blob/master/dist/models/Extender.js |
Two types of tests are current supported
##### Manual testing.
Manual simple loads and runs some basic parameter changes on Sound Models. This can be used for basic sanity checking of Sound Models.
Manual testing can be launched using the command gulp test.
##### Unit testing.
A jasmine based unit test suite helps test the basic usecase of the core Sound Model library as well as the individual Sound Models.
The unit test can be launched using gulp unittest`
##### JSM Player
JSM Player is a tool for testing the interaction and effects of the various parameters.
The source for the JSM Player is now in it's seperate repo.
- dist : 'compiled' artefacts for distribution
- models : compiled Sound Models for distribution
- core : seperated SPAudioBuffer for creating buffers
- effect : compiled Effects to add to Sound Models
- docs :
- api : autogenerated API docs
- dev : developer guide and cheat sheet
- src : documentation source
- core : core/shared sound functionality
- models : individual sound models
- effects : individual effects
- test : source for tests
- manual : source for manual tests
- unit : source for unit tests
Please raise issues if you find any bugs or want to request for new features for the Sound Models.
Sonoport Sound Models are licensed under the Apache License, Version 2.0. See the LICENSE file for more info.