Skip to content
Fast, JavaScript DSP library that creates JIT optimized audio callbacks using code generation techniques
Branch: v3
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist
docs
js
playground
resources
.gitignore
README.markdown Update README.markdown Sep 5, 2017
gulpfile.js
index.html
package.json

README.markdown

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 browser-based 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

http://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.init()
    
    // access objects in Gibberish namespace
    Gibberish.oscillators.Sine({ frequency:220 }).connect()
    
    // or export namespace to object of your choice 
    Gibberish.export( window )
    Sine({ frequency:220 }).connect()
  }
  </script>
</html>

Development dependencies

  • node 6 or better
  • npm
  • gulp

Building

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

  1. Run npm install in the top level directory
  2. Run gulp in the top level directory

If you don't have gulp installed:

  1. Run npm install in the top level directory
  2. Run npm install gulp-cli in the top level directory
  3. Run ./node_modules/.bin/gulp in the top level directory, or simply gulp if you have gulp installed globally.

This will create both a minimized and an un-minimized version of the library.

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

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 - affords audio-rate modulation of timing

License

Gibberish is licensed under the MIT license.

You can’t perform that action at this time.