diff --git a/README.md b/README.md
new file mode 100644
index 0000000..512dae2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,43 @@
+# grendy
+
+a simple drone synth, grendel drone commander inspired
+
+## Installation
+
+[Download latest release](https://github.com/cfdrake/grendy/archive/master.zip) and copy into `~/dust/code`.
+
+Or use Git:
+```
+<ssh into your Norns>
+$ cd ~/dust/code
+$ git clone git@github.com:cfdrake/grendy.git
+```
+
+Note that after installing you must `SYSTEM => RESET` your Norns before running this script, as it includes a new SuperCollider engine.
+
+## Norns Script
+
+The following controls are available for `grendy`:
+
+- Key 2 randomizes OSC/MIXER section
+- Key 3 randomizes FILTER/LFO section
+- Enc 1, Enc 2, and Enc 3 controls filter frequency and oscillator frequencies
+- Holding Key 1 + Enc 1, Enc 2, and Enc 3 controls filter resonance and LFO frequency/depth
+
+Tweak more parameters from the `[PARAMETERS] => [EDIT]` page.
+
+MIDI note input will round-robin set OSC1 and OSC2 frequency.
+
+## Synth Architecture
+
+- OSC: two oscillators, each crossfaded between square and triangle shapes
+- MIXER: balance control between OSC1 and OSC2
+- FILTER: Moog-modeled filter with cutoff and resonance control
+- LFO: saw and click shapes, crossfaded, affecting filter cutoff with depth control
+  - SAW: frequency control
+  - CLICK: rate control (N times SAW frequency), pulse width control
+- AMP: final volume control
+
+## SuperCollider Engine
+
+This script makes a new SuperCollider engine available, `Grendy`. Please see `lib/engine_grendy.sc` for the latest parameter definitions.
diff --git a/grendy.lua b/grendy.lua
new file mode 100644
index 0000000..a608332
--- /dev/null
+++ b/grendy.lua
@@ -0,0 +1,252 @@
+-- ~~ grendy ~~
+-- a simple drone synth
+-- grendel drone commander inspired
+-- v1.0.0 @cfd90
+--
+-- KEY2: randomize OSC/MIXER
+-- KEY3: randomize FILTER/LFO
+--
+-- ENC1: FILTER freq
+-- ENC2: OSC1 freq
+-- ENC3: OSC2 freq
+--
+-- KEY1+ENC1: FILTER res
+-- KEY1+ENC2: LFO freq
+-- KEY1+ENC3: LFO depth
+--
+-- Further tweak parameters via [EDIT] page
+--
+-- MIDI input round-robin sets OSC1 and OSC2 freq
+
+music = require 'musicutil'
+
+engine.name = "Grendy"
+
+------
+------ STATE
+------
+
+local shift = false
+local midiFirstOsc = true
+
+------
+------ INITIALIZATION
+------
+
+function init()
+  print("unleashing grendy...")
+  setup_params()
+  setup_midi()
+end
+
+function setup_params()
+  -- OSC1
+  params:add_separator()
+  params:add_control("freq1", "osc1 freq", controlspec.new(20, 360, 'exp', 0.5, 220, 'hz'))
+  params:set_action("freq1", function(x) engine.freq1(x) end)
+  
+  params:add_control("shape1", "osc1 shape [tri=>sqr]", controlspec.new(-1, 1, 'lin', 0.01, 1, ''))
+  params:set_action("shape1", function(x) engine.shape1(x) end)
+  
+  -- OSC2
+  params:add_separator()
+  params:add_control("freq2", "osc2 freq", controlspec.new(20, 360, 'exp', 0.5, 220, 'hz'))
+  params:set_action("freq2", function(x) engine.freq2(x) end)
+  
+  params:add_control("shape2", "osc2 shape [tri=>sqr]", controlspec.new(-1, 1, 'lin', 0.01, 1, ''))
+  params:set_action("shape2", function(x) engine.shape2(x) end)
+  
+  -- MIXER
+  params:add_separator()
+  params:add_control("mix", "osc mix [osc1=>osc2]", controlspec.new(-1, 1, 'lin', 0.1, 0, ''))
+  params:set_action("mix", function(x) engine.mix(x) end)
+  
+  -- FILTER
+  params:add_separator()
+  params:add_control("ffreq", "filter frequency", controlspec.new(20, 2000, 'exp', 0.5, 440, 'hz'))
+  params:set_action("ffreq", function(x) engine.ffreq(x) end)
+  
+  params:add_control("fres", "filter res", controlspec.new(0, 4, 'lin', 0.1, 1, ''))
+  params:set_action("fres", function(x) engine.fres(x) end)
+  
+  -- LFO
+  params:add_separator()
+  params:add_control("lfreq", "lfo frequency", controlspec.new(0.1, 20, 'lin', 0.1, 0.1, 'hz'))
+  params:set_action("lfreq", function(x) engine.lfreq(x) end)
+  
+  params:add_control("cspeed", "lfo click rate", controlspec.new(1, 16, 'lin', 1, 1, 'x'))
+  params:set_action("cspeed", function(x) engine.cspeed(x) end)
+  
+  params:add_control("cwidth", "lfo click width", controlspec.new(0.1, 0.9, 'lin', 0.1, 0.2, ''))
+  params:set_action("cwidth", function(x) engine.cwidth(x) end)
+  
+  params:add_control("lshape", "lfo shape [ramp=>click]", controlspec.new(-1, 1, 'lin', 0.1, -1, ''))
+  params:set_action("lshape", function(x) engine.lshape(x) end)
+  
+  params:add_control("ldepth", "lfo depth", controlspec.new(0, 1000, 'lin', 0.1, 0, ''))
+  params:set_action("ldepth", function(x) engine.ldepth(x) end)
+
+  -- AMP
+  params:add_separator()
+  params:add_control("amp", "amp", controlspec.new(0, 1, 'lin', 0.01, 1, ''))
+  params:set_action("amp", function(x) engine.amp(x) end)
+end
+
+function setup_midi()
+  m = midi.connect()
+  
+  m.event = function(data)
+    local d = midi.to_msg(data)
+    
+    if d.type == "note_on" then
+      -- Round-robin set OSC1 and OSC2
+      hz = music.note_num_to_freq(d.note)
+      
+      if midiFirstOsc then
+        params:set("freq1", hz)
+      else
+        params:set("freq2", hz)
+      end
+      
+      midiFirstOsc = not midiFirstOsc
+    end
+  end
+end
+
+------
+------ INPUT
+------
+
+function key(n, z)
+  -- Shift key
+  if n == 1 then
+    if z > 0 then
+      shift = true
+    else
+      shift = false
+    end
+    
+    redraw()
+  end
+  
+  -- Parameter randomization
+  if n == 2 and z == 1 then
+    randomize_osc()
+  elseif n == 3 and z == 1 then
+    randomize_filter()
+  end
+end
+
+function enc(n, d)
+  if shift then
+    -- SHIFT mode
+    -- Control filter res, LFO freq, LFO depth
+    if n == 1 then
+      params:delta("fres", d)
+    elseif n == 2 then
+      params:delta("lfreq", d)
+    elseif n == 3 then
+      params:delta("ldepth", d)
+    end
+  else
+    -- REGULAR mode
+    -- Control filter freq, OSC1 freq, OSC2 freq
+    if n == 1 then
+      params:delta("ffreq", d)
+    elseif n == 2 then
+      params:delta("freq1", d)
+    elseif n == 3 then
+      params:delta("freq2", d)
+    end
+  end
+end
+
+------
+------ DRAWING
+------
+
+function redraw()
+  screen.clear()
+  
+  -- Encoder documentation
+  if shift then
+    screen.move(0, 10)
+    screen.level(1)
+    screen.text("[ENC1] ")
+    screen.level(5)
+    screen.text("filter res")
+    screen.move(0, 20)
+    screen.level(1)
+    screen.text("[ENC2] ")
+    screen.level(5)
+    screen.text("lfo freq")
+    screen.move(0, 30)
+    screen.level(1)
+    screen.text("[ENC3] ")
+    screen.level(5)
+    screen.text("lfo depth")
+  else
+    screen.move(0, 10)
+    screen.level(1)
+    screen.text("[ENC1] ")
+    screen.level(5)
+    screen.text("filter freq")
+    screen.move(0, 20)
+    screen.level(1)
+    screen.text("[ENC2] ")
+    screen.level(5)
+    screen.text("osc1 freq")
+    screen.move(0, 30)
+    screen.level(1)
+    screen.text("[ENC3] ")
+    screen.level(5)
+    screen.text("osc2 freq")
+  end
+  
+  -- Key documentation
+  if not shift then
+    screen.move(0, 40)
+    screen.level(1)
+    screen.text("[KEY1] ")
+    screen.level(5)
+    screen.text("held, toggle page 2")
+  else
+    screen.move(0, 40)
+    screen.level(1)
+    screen.text("see params page for more")
+  end
+  
+  screen.move(0, 50)
+  screen.level(1)
+  screen.text("[KEY2] ")
+  screen.level(5)
+  screen.text("randomize OSC/MIXER")
+  screen.move(0, 60)
+  screen.level(1)
+  screen.text("[KEY3] ")
+  screen.level(5)
+  screen.text("randomize FILTER/LFO")
+  
+  screen.update()
+end
+
+------
+------ HELPERS
+------
+
+function randomize_osc()
+  params:set("freq1", 20 + (math.random() * (360 - 20)))
+  params:set("shape1", (math.random() * 2) - 1)
+  params:set("freq2", 20 + (math.random() * (360 - 20)))
+  params:set("shape2", (math.random() * 2) - 1)
+  params:set("mix", (math.random() * 2) - 1)
+end
+
+function randomize_filter()
+  params:set("ffreq", 20 + (math.random() * (2000 - 20)))
+  params:set("fres", math.random() * 3.5)  -- Don't go to 4, don't want to blast the user's ear with self-oscillation...
+  params:set("cspeed", 1 + (math.random() * (16 - 1)))
+  params:set("cwidth", 0.1 + (math.random() * (1 - 0.1)))
+  params:set("lshape", (math.random() * 2) - 1)
+  params:set("ldepth", math.random() * 1000)
+end
diff --git a/lib/engine_grendy.sc b/lib/engine_grendy.sc
new file mode 100644
index 0000000..c8b3fcc
--- /dev/null
+++ b/lib/engine_grendy.sc
@@ -0,0 +1,111 @@
+// CroneEngine_Grendy
+// SuperCollider engine for grendy
+
+Engine_Grendy : CroneEngine {
+	var <synth;
+
+	*new { arg context, doneCallback;
+		^super.new(context, doneCallback);
+	}
+
+	alloc {
+	  // Setup synth variable
+		synth = {
+			arg out,
+			  freq1 = 220, shape1 = 1,
+			  freq2 = 220, shape2 = 1,
+			  mix = 0,
+			  ffreq = 440, fres = 1,
+			  lfreq = 1, ldepth = 100, lshape = -1, cspeed = 1, cwidth = 0.2,
+			  amp = 1;
+			
+			// OSC1: Tri/Pulse crossfaded
+			var osc1 = XFade2.ar(LFTri.ar(freq1), Pulse.ar(freq1), shape1);
+			
+			// OSC2: Tri/Pulse crossfaded
+			var osc2 = XFade2.ar(LFTri.ar(freq2), Pulse.ar(freq2), shape2);
+			
+			// MIXER: OSC1/OSC2 crossfaded
+			var osc = XFade2.ar(osc1, osc2, mix);
+			
+			// LFO: Ramp/Click crossfaded
+			// Changes from GDC:
+			// - Pulse is not at same position of LFO cycle, undecided if this is worth investigating, it sounds nice as-is
+			// - Does not have "inverted" LFO shape
+			// - Adds ability to control pulse width of click signal
+			// - Adds ability to additional click divisions other than 2/4/8/16 for more interesting rhythms
+			var sr = SampleRate.ir;
+			
+	    var ramp = Phasor.ar(0, lfreq / sr, 0, 1);
+	    var click = Pulse.ar(lfreq * cspeed, cwidth);
+	    
+	    var lfo = XFade2.ar(ramp, click, lshape);
+	
+			// FILTER: input from OSC
+			var filter = MoogFF.ar(osc, ffreq + (lfo * ldepth), fres);
+			
+			// AMP: input from FILTER
+			var final = filter * amp;
+			
+			// OUTPUT stage
+			Out.ar(out, (final).dup);
+		}.play(args: [\out, context.out_b], target: context.xg);
+
+    // Setup Norns commands
+		this.addCommand("freq1", "f", { arg msg;
+			synth.set(\freq1, msg[1]);
+		});
+		
+		this.addCommand("shape1", "f", { arg msg;
+			synth.set(\shape1, msg[1]);
+		});
+		
+		this.addCommand("freq2", "f", { arg msg;
+			synth.set(\freq2, msg[1]);
+		});
+		
+		this.addCommand("shape2", "f", { arg msg;
+			synth.set(\shape2, msg[1]);
+		});
+		
+		this.addCommand("mix", "f", { arg msg;
+			synth.set(\mix, msg[1]);
+		});
+		
+		this.addCommand("ffreq", "f", { arg msg;
+			synth.set(\ffreq, msg[1]);
+		});
+		
+		this.addCommand("fres", "f", { arg msg;
+			synth.set(\fres, msg[1]);
+		});
+		
+		this.addCommand("lfreq", "f", { arg msg;
+			synth.set(\lfreq, msg[1]);
+		});
+		
+		this.addCommand("ldepth", "f", { arg msg;
+			synth.set(\ldepth, msg[1]);
+		});
+		
+		this.addCommand("lshape", "f", { arg msg;
+			synth.set(\lshape, msg[1]);
+		});
+		
+		this.addCommand("cspeed", "f", { arg msg;
+			synth.set(\cspeed, msg[1]);
+		});
+		
+		this.addCommand("cwidth", "f", { arg msg;
+			synth.set(\cwidth, msg[1]);
+		});
+		
+		this.addCommand("amp", "f", { arg msg;
+			synth.set(\amp, msg[1]);
+		});
+	}
+
+	free {
+		synth.free;
+	}
+}