JZZ-synth-Tiny

Tiny Web-Audio GM Synthesizer (g200kg/webaudio-tinysynth) wrapped for JZZ.js

Includes all General MIDI instruments, plus, you can load your own sounds.

Please check the demo...

Install

npm install jzz-synth-tiny
or yarn add jzz-synth-tiny
or get the full development version and minified scripts from GitHub

Usage

Plain HTML

1<script src="JZZ.js"></script>
2<script src="JZZ.synth.Tiny.js"></script>
3//...

CDN (jsdelivr)

1<script src="https://cdn.jsdelivr.net/npm/jzz"></script>
2<script src="https://cdn.jsdelivr.net/npm/jzz-synth-tiny"></script>
3//...

CDN (unpkg)

1<script src="https://unpkg.com/jzz"></script>
2<script src="https://unpkg.com/jzz-synth-tiny"></script>
3//...

CommonJS

1var JZZ = require('jzz');
2require('jzz-synth-tiny')(JZZ);
3//...

TypeScript / ES6

1import { JZZ } from 'jzz';
2import { Tiny } from 'jzz-synth-tiny';
3Tiny(JZZ);
4//...

AMD

1require(['JZZ', 'JZZ.synth.Tiny'], function(JZZ, dummy) {
2  // ...
3});

API

Play directly

1JZZ.synth.Tiny().noteOn(0, 'C5', 127)
2   .wait(500).noteOn(0, 'E5', 127)
3   .wait(500).noteOn(0, 'G5', 127)
4   .wait(500).noteOff(0, 'C5').noteOff(0, 'E5').noteOff(0, 'G5');

Register as a MIDI port

1JZZ.synth.Tiny.register('Web Audio');
2
3JZZ().openMidiOut('Web Audio').noteOn(0, 'C5', 127)
4   .wait(500).noteOn(0, 'E5', 127)
5   .wait(500).noteOn(0, 'G5', 127)
6   .wait(500).noteOff(0, 'C5').noteOff(0, 'E5').noteOff(0, 'G5');

To make vitual port visible by Web MIDI API, please check the instructions at https://github.com/jazz-soft/JZZ#virtual-midi-ports

Get/Set sound

1var synth = JZZ.synth.Tiny();
2var tuba = synth.getSynth(58); // tuba
3var drum = synth.getSynth(36, true); // bass drum
4synth.setSynth(0, tuba); // set tuba to program 0 (it was piano originally);
5synth.setSynth(35, drum, true); // set bass drum to percussion instrument 35;

See more details at https://github.com/g200kg/webaudio-tinysynth#timbre-object-structure

Using in Node.js with headless Web Audio

1const WAAPI = require('node-web-audio-api');
2const JZZ = require('jzz');
3require('jzz-synth-tiny')(JZZ);
4
5global.window = { AudioContext: WAAPI.AudioContext };
6
7JZZ.synth.Tiny()
8  .or(function() { console.log('Cannot open MIDI-Out!\n'/* + this.err() */); })
9  .note(0, 'C5', 127, 500).wait(500)
10  .note(0, 'E5', 127, 500).wait(500)
11  .note(0, 'G5', 127, 500).wait(500)
12  .note(9, 'C6', 127, 500).wait(500)
13  .and(function() { JZZ.lib.closeAudioContext(); });

More information

Please visit https://jazz-soft.net for more information.