By Sean Luke (sean@cs.gmu.edu)
This is a collection of code which runs on the Tangible Waves GRAINS module, though it can be adapted to run on any Arduino with little difficulty. All these projects are released under Apache 2.0 except for Lattice, which is released under GPL 2.0 (as it contains Mutable Instruments code), Oration/Oration 2, which are released under GPL 3.0 (as is Talkie), and likewise Elements, released under GPL 3.0 as it used GPL code.
Other GRAINS firmware repositories:
- AE Modular's GRAINS repository and GRAINS Mozzi repository
- NurdSpace's collection of GRAINS firmware
- Duddex's GRAINS adaptations
- Keurslager Kurt's GRAINS LFO
- WonkyStuff's GRAINS projects
- Ginkosynthese's original GRAINS examples
Not a GRAINS project per se. This is a lightweight MIDI library designed for small controllers. I have developed it for the various MIDI-controlled projects on this page.
Status: Under Development.
A MIDI-Controlled monophonic oscillator. You can choose between Sine and either Saw, Triangle, or Square. Requires Mozzi.
Status: Working. But every once in a while I'll get a MIDI error due to the use of software serial. This likely isn't fixable until we move to a hardware UART if/when TW decides to come out with Grains V2 (no, I have no information on that).
A MIDI-Controlled 3-voice paraphonic oscillator, meant to play chords from your keyboard or DAW or groovebox. You can choose between Sine and either Saw, Triangle, or Square. Requires Mozzi.
Status: Working. But every once in a while I'll get a MIDI error due to the use of software serial. This likely isn't fixable until we move to a hardware UART if/when TW decides to come out with Grains V2 (no, I have no information on that).
An warpable LFO with pulse (with pulse width), warpable saw/tri/ramp, and warpable sine waves, with a wide range of rates. Can be reset, and outputs a sync trigger. Requires Mozzi.
Status: Working. However GRAINS can only reach about 4V, so it goes about 0-4V or so.
A nasty bitcrusher. Requires Mozzi.
Status: Working. It helps that the arduino is already pretty aliased! Mozzi must be modified to use Bit, which may not be worthwhile.
A ByteBeat emitter in the style of AlgoDrone or ByteBeat-Xfade. You can choose from 16 Bytebeats, sort of change their pitch and speed, change their volume, and reset them. You can of course define your own ByteBeats. Requires Mozzi.
Status: Working. Maybe at some point I'll figure out how to hack Mozzi to allow real pitch control.
A 4-voice Karplus-Strong string plucking simulator. Requires Mozzi.
Status: Working, but because it has to commit to a pitch immediately (to build the Karplus-Strong sample table) sometimes it can get off pitch on some notes thanks to GRAINS/Mozzi's inaccuracy in Analog Input reads. Could use some work there.
A 16-note random melody generator. Think of it as Topograf / Lattice for notes rather than drums. Requires Mozzi.
Status: Working, but GRAINS's severe limits on note output range can hamper things.
A USB Router, Note Distributor, MPE breakout, and MIDI filter.
Status: All current modes are working. Lots of stuff, like USB MIDI clock, drum triggers, MIDI routing, MPE, note distribution, removing legato from Wonkystuff modules, CC injection from pots, creation of MIDI notes from gate/cv, etc. There's also instructions for routing MIDI directly from GRAINS into your MB/1 or MASTER I/O via their TRS inputs, if you're daring and willing to accidently fry your MASTER I/O or MB/1. :-)
A Note Quantizer. Requires Mozzi.
Status: Working, but requires a lookup table to deal with some nonlinearity in the pitch output of GRAINS. The table is tuned for my GRAINS: let me know if it's working for yours as well.
A filtered and unfiltered white noise generator, plus various forms of Sample and Hold. Requires Mozzi.
Status: Working, but I was hoping to do pink noise as well, but am having some hiccups. Ran into a lot of Mozzi bugs, reported.
An oscillator which produces random sine waves along a certain chord, much like a wind chime. Requires Mozzi.
Status: Working. A bit hissy, but what can you do, it's Mozzi.
An ADSR envelope generator with optional ASR and AHR configurations. Requires Mozzi.
Status: Working.
An oscilloscope with four switchable analog/digital inputs, an extra digital input, and a little digital function generator. Uses the Serial Plotter on your laptop's Arduino IDE. Status: Working
A multi-stage envelope with exponential transitions and many options, including sustain loops, whole-envelope loops, resetting, optional flat (sample-and-hold style) stages, and per-stage triggering. You can set the minimum and maximum envelope values. Supports up to 145 stages. Requires Mozzi.
Status: Working. The rate calculation is obnoxious and I should come up with a better mechanism. One or two minor bugs but it's quite usable.
A wavetable synthesizer over your choice of waveforms from the Adventure Kid Waveform (AKWF) collection, plus a low-pass filter. Requires Mozzi.
Status: Working. The waveforms are pretty aliased (not AdventureKid's fault, Mozzi's fault), and so sound pretty crummy at different positions.
A drum sampler for up to 9 samples and up to 5 triggers. Comes with several 8-bit drum samples, including, yes, ones from the TR-808. You can provide your own samples, and there are a variety of configurations. Allows 8-bit raw and u-Law samples. Requires Mozzi.
Status: Working. This is a major upgrade from the previous 808 version.
A complete synthesizer voice: oscillator, 2-pole filter, and amplifier. You provide the envelopes. Square, Sawtooth, and Triangle waves offered, plus Low-pass, High-pass, Band-pass, and Notch filter types. Requires Mozzi.
Status: Working, but the filter is not amazing, particularly at high resonance and frequency. Sawtooth is a bit buzzy here and there (just not enough memory to put in more waves).
A random walk generator (free or about a mean), plus sample and hold, plus added fuzz. Requires Mozzi.
Status: Working
A combination fixed-lag smoother (slew), summed attenuverter, and noise-fuzzer. Requires Mozzi.
Status: Working
A chording oscillator which can cross-fade between sine and either square, saw, or triangle (selectable in code). Requires Mozzi.
Status: Working. Some of the waves are buzzy in certain locations, but we don't have enough dynamic memory left to smooth things out.
An evolving drone synthesizer using the same additive synthesis technique as Booker. Requires Mozzi.
Status: Working. Pretty hissy for same reason as Booker.
A Hammond Organ simulator with a built-in Leslie and a variety of organ drawbar combinations. Requires Mozzi.
Status: Working, but it pushes Mozzi to its limits I think, and so is pretty hissy.
A four-channel boolean pattern generator based on an analog input, with 21 interesting patterns. Can output its patterns as gates or as triggers.
Status: Working, but its use with LFOs is poor due to noise.
A Euclidian trigger sequencer with up to 32 steps and both forward and backward sequences and various other options.
Status: Working
A new implementation of Talkie which lets you select and speak multiple sentences, or random words within a sentence, from words selected from the entire Talkie vocabulary, not just a small subset.
Status: Working
A variation of Oration which uses an older version of Talkie, and so can vary pitch and speed independently. It's also a bit louder: but the sound quality is iffy. Let me know which one you like better.
Status: Working
A clone of Mutable Instruments GRIDS. This is essentially a "TOPOGRAF Light". It does the same thing but, due to limitations in GRAINS's interface, it has to simplify the parameters. There are different configurations provided for doing so.
Status: Working
A four-track step sequencer with song mode, capable of performing songs of up to 800 trigger patterns, each pattern between 1 and 256 steps long. You program the patterns in the code, it's set up to be very easy. Each pattern can loop for some N iterations (specified per-pattern), or loop forever. You can reset, advance to the next pattern, and add swing and randomness in real time.
Status: Working
A three-output random trigger generator and Bernoulli trigger. You provide a clock input and the probability that, for each output, the output will generate a trigger for a given clock. You can make the track outputs independent or exclusive (only and exactly one triggers each clock).
Status: Working
A two- or three-output square-wave LFO generator. Options include two independent LFOs, one with pulsewidth; three Square-wave LFOs all with 50% pulse width; and a mixture of three Square-wave LFOs in the same output. You can reset and sync two LFOs to the third.
Status: Working
One, Two, or Three digital outputs set up as functions of four, five, or six analog+digital inputs. You specify the functions in the code (it's set up to make it easy!), including special randomness and logic functions.
Status: Working, but like Pattern, its usefulness may be limited due to noise.
A two-track clock divider with a variety of division options.
Status: Working. I've had a few rare premature resets: let me know if the beat gets off and when.
A two-track clock multiplier with a variety of multiplication options.
Status: Working. Could use some improvement.