CHORDELLE - CHEAT SHEET                  patch for Organelle (Pure Data vanilla)
================================================================================
CONTROLS
  Knobs 1-4    parameters of the active page (pick-up: turn past the value)
  Encoder      turn = key | click = HOLD | hold down + turn = BPM
  Aux          hold = menu | tap = close loop / start-stop sampler REC
  Aux + enc    turn = next/previous scale | click = Organelle system menu
  LED          red = REC | purple = DUB | green = HOLD
  Display      L1 key+scale | L2 chord+note | L3-4 knobs | L5 page/status/hint

KEYBOARD
  Low white    7 CHORDS of the scale (I ii iii IV V vi vii)
  High white   7 NOTES of the scale
  Low black    hold:  C# sus2 | D# sus4 | F# 7th | G# 9th | A# strum
  High black   hold:  C# oct- | D# oct+ | F# vibrato | G# bend +2 | A# tremolo
  Ext MIDI kbd C4-B5 = the Organelle keys; below C4 = chords 1-4 oct lower,
               C6 and up = notes 1-3 oct higher (always on)
  Scales       Major Minor HarmMinor MelMinor Dorian Phrygian Lydian
               Mixolydian Locrian PentMajor PentMinor Blues WholeTone

AUX MENU (black keys pick the cells, encoder flips the 6 screens)
  left column = low black keys C# D# F# G# A#, right column = high black keys
  1 LOOPER     Play | Rec | Dub | Undo | Clear || Main | Gate | Click | Quant |>
  2 SOUND      Ch Sound | Ch Filter | Ch ADSR | Scale | Octave
               || Nt Sound | Nt Filter | Nt ADSR | Link | >
  3 FX + GEN   G: Gate | X: Crush | Tape | Drive | LFO
               || Gen Ch | Gen Nt | Gen Play/Stop | EQ | >
  4 SAMPLERS   S1 Play | S1 Level | S1 Grain | S1 Shape | Accorda (auto-tune)
               || S2 Play | S2 Level | S2 Grain | S2 Shape | >
  5 SAMPLERATOR Start/Stop | SR Note | SR Tempi | SR Loop | SR Opzioni
               || Test | Export | Import | Delete (2nd press confirms) | >
  6 SYSTEM     Strum (2nd press = HOLD) | Delay | Tap tempo (+ BPM page) | Sync
               | Keys || Preset | Save | Load | Out Stereo/Split | Panic
  G: X: Scale Link   1st press = open page, next presses = cycle / toggle
  Reopens on the screen you left (after a page change: on that page's screen)

KNOB PAGES                    1            2            3            4
  Main                        Ch vol       Ch cutoff    Nt vol       Nt cutoff
  Ch / Nt Sound               Sound        Detune       Reverb       Delay send
  Ch / Nt Filter              Type         Cutoff       Resonance    Env
  Ch / Nt ADSR                Attack       Decay        Sustain      Release
  Octave                      Ch oct       Nt oct       -            -
  Scale                       ChShift      Spread       Shift(notes) Key
  Strum                       Dir          Speed        Rhythm       Var
  Link                        Sound        Filter       ADSR         FX
  Gate                        Rate         Var          Len          Depth
  Crush                       Bits         Down         Var          Mix
  Tape                        Wow          Flutter      Age          Amount
  Drive                       Drive        Type         Tone         Mix
  LFO                         Rate         Shape        Depth        Phase
  EQ                          Low          Mid          High         Pump
  Gen Ch                      Algorithm    Rate         Var          Len
  Gen Nt                      Algorithm    Rate         Dens         Rng
  Delay                       Algorithm    Division     Feedback     Tone
  BPM (Tap tempo cell)        BPM          -            -            -
  Keys                        Chord vel    Note vel     Mod wheel    Vel>filter
  S1 / S2 Play                Slot         Mode         Start        Len
  S1 / S2 Level               Gain         Tune         Fine         Tone
  S1 / S2 Grain               Size         Dens         Scan         Spray
  S1 / S2 Shape               Fade In      Fade Out     Loop         Rnd
  Preset                      Slot         -            -            -
  SR Note                     From         To           Step         Monitor
  SR Tempi                    Hold         Tail         MAN/MIDI1-16 Velocity
  SR Loop                     Start/OFF    End          Fade         -
  SR Opzioni                  Slot 1-4     Mem SD/USB   Archive 1-99 In L+R/L/R

SOUNDS
  Synth        SIN TRI SAW SQR SUPER JUPITER-4 HS-80 GLASS CHIP CHOIR WARBLE
               ORGAN (full drawbar) BELL (glockenspiel)
  Keys         GRANDPIANO BRIGHTPIANO ARPA
  Strings      VIOLIN CELLO       Winds   TRUMPET TROMBONE SAX
  Voices       DONNA AH, DONNA LA
  Yours        SAMPLER1 SAMPLER2 (slots = samples/1.wav ... 8.wav)
  Sampled      SYNTH1-4: made by the SAMPLERATOR from your synth
  Detune       2-osc sounds: 2nd oscillator; all others: +/- detuned copies

LOOPER
  Rec          1 bar count-in, records keys + modifiers, max 16 bars
  Rec again    (or tap Aux) closes the loop and plays it
  Play / Dub   start-stop / overdub      Undo  last take (again = redo)
  Quantize     1/16 -> 1/8 -> 1/4 -> Off

SCALE PAGE
  ChShift      chords moved -7..+7 degrees in key (+1: I->ii, V->vi)
  Spread       CLOSE | OPEN | BASS | WIDE chord voicing
  Shift        notes harmonized -7..+7 degrees, always in key (+2 = a third)
  Key          notes transposed -6..+6 semitones from the chords

STRUM PAGE
  Dir          AUTO | DOWN | UP | RANDOM order
  Speed        10-300 ms between strings (shortened automatically in rhythms)
  Rhythm       OFF 1/4 1/8 FOLK REGGAE GALLOP FUNK EUCLID RANDOM
               runs while A# is held (or with Strum HOLD); each strum mutes
               the previous one; follows BPM / MIDI clock
  Var          drops / adds strums; EUCLID = hits; RANDOM = density

EFFECTS
  Filter       LP | MOOG | HP | BP | NOTCH, Env = pluck (uses ADSR Decay)
  Gate         EVEN TRANCE OFFBT DOTTED TRESIL HALF EUCLID RANDOM MANUAL LFO
  Crush        STATIC GATE INVERT RAMP LFO RANDOM BURST; Bits 8->1
  Tape         wow, flutter, aging drags and dropouts, saturation
  Drive        SOFT | HARD | FUZZ | FOLD
  Reverb       send on Sound page: more send = louder AND longer tail
  Delay        Alg: DRITTO (plain) or Gate patterns / LFO chopping the repeats
               (1 step = 1 division); Div 1/2 1/4 1/4D 1/4T 1/8 1/8D 1/8T 1/16
               (D = dotted x1.5, T = triplet x2/3); R = double time (ping-pong)
               Tone = colour of all repeats (darker on each pass)
  LFO          4BAR..1/16; SIN TRI RAMP+ RAMP- SQR STEP; drives G:, X:, D: LFO
  EQ           3-band +-15 dB, Pump = synced ducking, final limiter
  Link         chords and notes share Sound / Filter / ADSR / FX (per group)
  CPU          effects set to zero switch themselves off

GENERATIVE (follows BPM or MIDI clock, plays in key, you can play along)
  Chords       PROG CIRCLE WALK RANDOM DRONE; Rate 2BAR..1/4, SYNC
  Notes        UP DOWN UPDOWN ARPRND WALK RANDOM EUCLID TURING
  Knob 1 left  = off; Gen Play/Stop pauses everything

TEMPO, SYNC, KEYS
  BPM          40-240 (BPM page or encoder hold + turn), shared by everything
  Tap tempo    tap 2+ times (internal sync), also opens the BPM page
  Sync MIDI    follows external clock; Start / Stop drive looper and generative
  Keys page    velocity -> chord / note volume; mod wheel (CC1) -> Vibrato,
               Filtro, Tremolo or Drive; Vel>filter = soft playing darker

SAMPLER
  Record       tap Aux on a sampler page (start / stop), max 20 s
  Load         copy a WAV as samples/N.wav (mono/stereo, max 20 s)
  Modes        ONESHOT | LOOP | REVERSE | GRAIN; C4 = original pitch
  Level        Gain -12..+24 dB (auto-normalized), Tune, Fine, Tone
  Accorda      menu 4 cell 5: finds the sample's note, sets Tune/Fine so C4 = C
  Grain        Size: left 10-500 ms, right in time 1/64-1/2; Dens (2nd half =
               resonator), Scan, Spray (from 40% grains play scale notes)
  Shape        Fade In, Fade Out (0-2 s), Loop point, Rnd start

SAMPLERATOR (samples your synth: MIDI out + audio in -> SYNTH1-4)
  Setup        synth MIDI on the Mode channel (SR Tempi), audio into the input
  Test         plays the middle note, shows input level (ideal -18..-3 dB)
  Start        waits for silence, plays each note, records Hold + Tail;
               progress page "Note 3 of 13"; press again to stop
  Range        From/To (C1-C7), Step 1-12 semitones, max 48 notes
  MANUALE      Mode fully left: you play each note shown on the display
  Loop         Start/End/Fade per instrument, no need to resample
  Mem          samples on SD (patch folder) or USB (Chordelle_samplerator)
  Archive      99 instruments on USB stick (folder Chordelle_archivio):
               Export = slot -> archive, Import = archive -> slot, Delete = slot

PRESETS AND OUTPUT
  Presets      8 slots: all pages, key, scale, BPM, link... (not the loop)
  Backup       copy chordelle_presets*.txt before updating the patch
  Out Split    chords on LEFT, notes on RIGHT
  Panic        releases stuck notes and modifiers
================================================================================
