README

Gibberish

Gibberish is designed to be a fast audio API for the browser. It takes the low-level building blocks provided by genish.js and uses them to create higher-level synthesizers, effects, and sequencers. Gibberish proceses each sample of each synthesis block one sample at a time, enabling a variety of effects not typically possible in JavaScript synthesis systems, most importantly single-sample feedback loops and audio-rate modulation of scheduling.

Note that this branch is for version 3 of the library. See the master branch for the pre-June 2017 version that is currently used in Gibber. There is also a tagged release of the older version (2.0.0).

Live Code Playground

https://www.charlie-roberts.com/gibberish/playground

Example Code

kik = Kick().connect() // connects to master output by default

// sequence calls to 'trigger' method of kick drum every 1/2 second
// with alternating loudness levels.
seq  = Sequencer.make( [.25,.5], [22050], kik, 'trigger' ] ).start()

chr = Chorus().connect()
syn = PolySynth({ maxVoices:4, attack:44, decay:22050, gain:.1 })

// connect to chorus and master output
syn.connect( chr ).connect()

syn.chord( [220,330,440,550] )

HTML + Initialization

<!doctype html>

<html lang='en'>
  <head>
    <script src='dist/gibberish.js'></script>
  </head>

  <body></body>
  
  <script>
  window.onload = function() {
    Gibberish.workletPath = 'dist/gibberish_worklet.js'

    Gibberish.init().then( ()=> {
      Gibberish.export( window )
      
      Sine().connect() 
    })
  }
  </script>
</html>

Development dependencies

node 6 or better
npm
gulp

Building

You need to have node.js and gulp installed. Then:

Run npm install in the top level directory
Run gulp in the top level directory
Run gulp minify if you'd like to create minified and gzipped versions of the library.

The library will then be found in the dist folder.

Ugens

Gibberish includes a long list of oscillators, fx, and synthesis algorithms.

Oscillators

Sine
Triangle
Saw (wavetable & anti-aliased)
PWM (algorithmic & anti-aliased)
Square (wavetable & anti-aliased)
Noise( white, pink, brown )
Sampler - read audiofiles and playback at various speeds

Synthetic Percussion (TR-808 emulation)

Kick
Snare
Clave
Tom
Cowbell
Hat
Conga

Synths

All synths also have polyphonic versions.

Synth - oscillator + optional filter + envelope
Monosynth - three oscillators + optional filter + envelope
FM - two op FM synthesis + optional filter + envelope
Karplus-Strong - Physical model of a plucked string
Complex - oscillator + wavefolder + filter + envelope

Effects

BitCrusher - bit depth and sample rate reduction
Buffer Shuffler
Chorus (arp solina model)
Delay
Distortion
Flanger
Ring Modulation
Reverb (freeverb and dattorro plate reverb models)
Vibrato

Filters

State Variable Filter (12 db resonant)
Biquad Filter (12 db resonant)
Ladder Filter ("Moog-style" 24db resonant)
"Virtual Analog" (aka implicit) Ladder Filter ("Moog-style" 24db resonant)
"Virtual Analog" (aka implicit) ZDF filter (a la TB-303)

Analysis

Envelope Follower

Sequencing

Seq - sample-accurate scheduling
Seq2 - provides audio-rate modulation of timing

License

Gibberish is licensed under the MIT license.

gibberish-dsp

Usage no npm install needed!