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:
- Run
npm installin the top level directory - Run
gulpin the top level directory
If you don't have gulp installed:
- Run
npm installin the top level directory - Run
npm install gulp-cliin the top level directory - Run
./node_modules/.bin/gulpin the top level directory, or simplygulpif 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.