https://github.com/jazz-soft/jzz-synth-tiny

Tiny Web-Audio GM Synthesizer
https://github.com/jazz-soft/jzz-synth-tiny

general-midi midi web-audio webaudio

Last synced: about 1 month ago
JSON representation

Tiny Web-Audio GM Synthesizer

• Host: GitHub
• URL: https://github.com/jazz-soft/jzz-synth-tiny
• Owner: jazz-soft
• Created: 2018-10-17T00:55:45.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2024-09-14T01:28:17.000Z (3 months ago)
• Last Synced: 2024-11-14T15:12:11.804Z (about 1 month ago)
• Topics: general-midi, midi, web-audio, webaudio
• Language: JavaScript
• Homepage:
• Size: 104 KB
• Stars: 20
• Watchers: 2
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

        
# JZZ-synth-Tiny

[![npm](https://img.shields.io/npm/v/jzz-synth-tiny.svg)](https://www.npmjs.com/package/jzz-synth-tiny)

[![npm](https://img.shields.io/npm/dt/jzz-synth-tiny.svg)](https://www.npmjs.com/package/jzz-synth-tiny)

[![jsDelivr](https://data.jsdelivr.com/v1/package/npm/jzz-synth-tiny/badge)](https://www.jsdelivr.com/package/npm/jzz-synth-tiny)

[![build](https://github.com/jazz-soft/JZZ-synth-Tiny/actions/workflows/build.yml/badge.svg)](https://github.com/jazz-soft/JZZ-synth-Tiny/actions)

[![Coverage Status](https://coveralls.io/repos/github/jazz-soft/JZZ-synth-Tiny/badge.svg)](https://coveralls.io/github/jazz-soft/JZZ-synth-Tiny)

[![Try jzz-synth-tiny on RunKit](https://badge.runkitcdn.com/jzz-synth-tiny.svg)](https://npm.runkit.com/jzz-synth-tiny)

Tiny Web-Audio GM Synthesizer 

([g200kg/webaudio-tinysynth](https://github.com/g200kg/webaudio-tinysynth))

wrapped for [JZZ.js](https://github.com/jazz-soft/JZZ)

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

Please check the [demo](https://jazz-soft.github.io/modules/tiny/index.html)...

## Install

`npm install jzz-synth-tiny`  

or `yarn add jzz-synth-tiny`  

or get the full development version and minified scripts from [**GitHub**](https://github.com/jazz-soft/JZZ-synth-Tiny)

## Usage

##### Plain HTML

```html

//...

```

##### CDN (jsdelivr)

```html

//...

```

##### CDN (unpkg)

```html

//...

```

##### CommonJS

```js

var JZZ = require('jzz');

require('jzz-synth-tiny')(JZZ);

//...

```

##### TypeScript / ES6

```ts

import { JZZ } from 'jzz';

import { Tiny } from 'jzz-synth-tiny';

Tiny(JZZ);

//...

```

##### AMD

```js

require(['JZZ', 'JZZ.synth.Tiny'], function(JZZ, dummy) {

  // ...

});

```

## API

##### Play directly

```js

JZZ.synth.Tiny().noteOn(0, 'C5', 127)

   .wait(500).noteOn(0, 'E5', 127)

   .wait(500).noteOn(0, 'G5', 127)

   .wait(500).noteOff(0, 'C5').noteOff(0, 'E5').noteOff(0, 'G5');

```

##### Register as a MIDI port

```js

JZZ.synth.Tiny.register('Web Audio');

JZZ().openMidiOut('Web Audio').noteOn(0, 'C5', 127)

   .wait(500).noteOn(0, 'E5', 127)

   .wait(500).noteOn(0, 'G5', 127)

   .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

```js

var synth = JZZ.synth.Tiny();

var tuba = synth.getSynth(58); // tuba

var drum = synth.getSynth(36, true); // bass drum

synth.setSynth(0, tuba); // set tuba to program 0 (it was piano originally);

synth.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

```js

const WAAPI = require('node-web-audio-api');

const JZZ = require('jzz');

require('jzz-synth-tiny')(JZZ);

global.window = { AudioContext: WAAPI.AudioContext };

JZZ.synth.Tiny()

  .or(function() { console.log('Cannot open MIDI-Out!\n'/* + this.err() */); })

  .note(0, 'C5', 127, 500).wait(500)

  .note(0, 'E5', 127, 500).wait(500)

  .note(0, 'G5', 127, 500).wait(500)

  .note(9, 'C6', 127, 500).wait(500)

  .and(function() { JZZ.lib.closeAudioContext(); });

```

## More information

Please visit [**https://jazz-soft.net**](https://jazz-soft.net) for more information.