📖 Table of Contents (Tap to Navigate)▼
1. Introduction & 2-Layer Workflow Concept
What You Say? (v1.0.0) brings 1970s/1980s Linear Predictive Coding (LPC) talking toys, arcade speech boards, and hardware circuit-bending into a playable, melodic DAW instrument and vocal-tract vocoder.

Figure 1.1: 2-Layer Interface (1200 × 860) — Permanent Top Synth & Circuit-Bend Console above the switchable Vox Roll / Live Keyboard workspace.
- Permanent Top Console (
226 px): Retro VFD, Tin-Toy Robot, 5 Vintage Speech Chips, Voice/Vocoder routing, Circuit Bends, Address Stutter, and the 10-Stage Vocal Tract +D0..D9Data Bus remain always visible at full size. - Switchable Lower Workspace (
522 px): Choose[ VOX ROLL ]for melodic syllable-stretched Piano-Roll lyric sequencing, or[ LIVE KEYBOARD ]for direct MIDI keyboard triggering across Phrase Stepper, Word Pads, ROM Glitch, and the 2-Octave Phoneme Organ. - Orthogonal Routing:
Voices [Mono | Poly | Choir],Source [Chip | Vocoder],[Freeze], and[Spell A-Z]combine freely across every chip model and both workspaces.
2. Signal Architecture: Dry Core vs. Circuit-Bent Twin
Every active voice runs two synchronized 10-pole LPC lattice engines in parallel so lyrics remain intelligible even while the bent layer screams:
3. Top Header Bar: Workspace Switcher, Presets & Master I/O

Figure 3.1: Workspace Switcher, Preset Browser (25 Factory Presets + User .wyspreset), Randomize Dice, Mix/IO Lock, and Master Meters.
[ VOX ROLL ]/[ LIVE KEYBOARD ]: Switches workspaces non-destructively — your lyrics, Piano-Roll notes, and synth controls stay completely intact.- Preset Browser (
[<] [>] [Preset] [Save] [Delete]): Browse 25 factory presets or save portable.wyspresetfiles persisting all parameters, multi-line lyrics, fullVox Rollsequence, and customD0..D9pin masks. - Randomize (Dice Button): Musical randomizer for chip model, voice tuning, and circuit bends — never overwrites your lyrics or
Vox Rollnotes, and honors the Mix/IO padlock. - Master Strip: Input drive/sidechain gain, parallel Dry/Wet blend, Mix/IO Lock icon, master Output trim, and clickable peak/RMS clip meters.
4. Permanent Synth & Circuit-Bend Console (4 Blocks)

Figure 4.1: Block 1 (VFD & Automaton), Block 2 (Voice & 5 Chips), Block 3 (Circuit Bends & Stutter), and Block 4 (K1..K10 Scope & D0..D9 Bus).
Block 1: VFD & Automaton
Live vacuum-fluorescent display showing workspace badge, phoneme code ([IH]), MIDI note & Hz, active voices (0V..8V), glowing word/letter, and bar/word counter — paired with an animated Tin-Toy Robot that sleeps with Z z z bubbles when idle, tracks your cursor when awake, and chomps in sync with live vowel formants. Click either to audition at C4!
Block 2: Voice & 5 Vintage Speech Chips
| Chip | Hardware Inspiration | Sonic Character & Bend Behavior |
|---|---|---|
| 5220 | TI TMS5100 / TMS5220 (Speak & Spell, Atari) | 10-pole lattice LPC, 51-sample glottal chirp & 13-bit LFSR. Data-bus XOR yields throat-singing drones and alien vowels. |
| 0256 | GI SP0256-AL2 (Intellivoice, home computers) | 6-stage cascade allophone LPC & 16-bit Galois LFSR. Nasal, steppy, classic 8-bit robot diction. |
| SC01 | Votrax SC-01A (Q*bert, Kraftwerk) | 9-step transistor-ladder glottal wave & analog switched-capacitor formants. Screams like an acid synth under high Q-Res! |
| VLM | Sanyo VLM5030 (Konami arcades) | 8-bit LPC-10 with coarse 3-bit K5–K10 stages & double-impulse punch. Crunchy arcade stutter loops. |
| 6295 | Oki MSM6295 (Capcom CPS-1) | 7.58 kHz 4-bit ADPCM arcade voice chip with chesty Rosenberg excitation and gritty nibble bends. |
Includes Tune (±24 st), Speed (0.25x..2.50x), Grunge (0..100%), Scrub (0..100%), Source [Chip | Vocoder], Voices [Mono | Poly | Choir], [Sync: Off/BPM/Grid], [Glide], and [Freeze].
Block 3 & Block 4: Circuit Bends, Stutter & D0..D9 Bus Matrix
- Circuit Bends:
Clock(±24 st, Pitchwheel ring),Bit-Flip(0..100%, Modwheel ring),Q-Res(0..100%, Velocity/Aftertouch ring),Vel->Q, quickXOR Bus [Vowel K1-4 | Throat K5-10 | All]presets, and liveLIM READY / GRsafety limiter readout. - Recessed Address Stutter Box:
[Stutter]hold,[Sync Wet]pointer phase lock,Size(1..8frames),Rate(0.25x..4.0x), andJitter(0..100%). - 10-Stage Vocal Tract & D0..D9 Pins: Real-time
K1..K10Dry vs. Wet reflection scope + 10 interactive hardware data-bus pins (left-click to toggle bit corruption on any stage; right-click to solo a single pin).
5. Workspace A: VOX ROLL (Melodic Lyric Piano-Roll Sequencer)

Figure 5.1: 2-Row Sequencer Toolbar, Collapsible Multi-Line Lyrics Sidebar, Timeline Minimap, Syllable Note Blocks & 6 Expression Lanes.
- 2-Row Sequencer Toolbar:
[Play Loop](Space),[Trig: Free / Retrig / Latch],[Follow], 4 Motif Generators (Cyber Hook,Robot Arp,Talkbox Lead,Robot Choir), unlimited Bars[-][+],[Fit Lyrics],[.MID]Import/Export, Grid (1/4..1/16T), Swing (50%..67%), Key & 8 Scales,[Cons: 35%..250%]consonant speed, and 64-step[Undo]/[Redo]. - Collapsible Lyrics Sidebar: Shared live text buffer with
[Load],[Paste],[Syllables (-)](automatic CMU Dictionary hyphenator), and[Spell A-Z]. Collapse anytime for full1168 pxPiano-Roll width. - Syllable Note Blocks & 6 Expression Lanes: Cyan leading consonants, emerald vowel core with LPC energy contour, S-curve
F0pitch-glide + vibrato spline, marquee multi-select, ripple resize, drag-and-drop.mid/.txt/.lrcimport, and 6 switchable lanes: Vibrato, Velocity, Ratchet (1x..8x), Clock / Formant, Bit-Flip XOR, and Legato Glide.
6. Workspace B: LIVE KEYBOARD (Direct MIDI Performance)

Figure 6.1: Live Keyboard Workspace — Phrase Stepper, Word Pads (C2+), 64-Cell ROM Glitch Matrix, and 2-Octave Phoneme Organ.
1 · Phrase Stepper
Every MIDI Note-On (or chord in Poly/Choir) speaks the next word or syllable in your shared text buffer at exact played pitch.
2 · Word Pads (C2+)
Maps each word token to its own dedicated MIDI pad from C2 (MIDI 36) upward for instant rhythmic vocal chops.
3 · ROM Glitch
Interactive 64-cell (8×8) LPC ROM dump matrix (x00..x3F) — click/drag cells or play MIDI keys to fire raw glitched phoneme frames.
4 · Phoneme Organ (C3..B4)
2-octave visual keyboard: 14 white keys sustain singing vowels (AA, EH, IY, AE, OW, UW, ER); 10 black keys fire crisp consonants (SS, TT, KK, PP, SH, RR).
7. Lyrics Syntax: Syllables (-), Pauses (, .), Rests (_) & Spell A-Z
| Syntax / Toggle | Example | Musical Behavior |
|---|---|---|
| Hyphen (-) | RO-BOT-IC | Splits a word into separate singing syllables across notes, or click [Syllables] for automatic CMU Dictionary hyphenation. |
| Comma (, ; :) | HELLO, WORLD | Appends a natural short breath pause (+6 silent frames) after the word without consuming an extra note. |
| Period (. ! ? ...) | SYSTEM READY. | Appends a longer phrase pause (+12 frames, or +20 for ...) at the end of the word. |
| Underscore (_) | WE ARE _ ROBOTS | Inserts an explicit silent musical [REST] token (_ = 1x, __ = 2x, ___ = 3x) occupying its own step/beat. |
| [Spell A-Z] | SPEAK → S-P-E-A-K | Spells every word character-by-character across either Live Keyboard or Vox Roll notes. |
8. Live MIDI Performance & Controller Mapping
| MIDI Input | Performance Function |
|---|---|
| Notes D0 – G8 | Vocal pitch & chord harmony (Live Keyboard), or live transposition & 8-voice chord harmonization (Vox Roll) |
| Keyswitch C0 (12) | Reset word/letter cursor to Word #1 (and restart Vox Roll at Beat 0) |
| Keyswitch C#0 (13) | Momentary Address Stutter Hold while held |
| Sustain Pedal (CC64) | Momentary Address Stutter Hold while depressed |
| Pitchbend Wheel | Live Clock Starve (±12 semitones chip under/overclock) |
| Modwheel (CC1) | Live Bit-Flip XOR depth (or manual Scrub position when Freeze is ON) |
| Velocity & Aftertouch | Dynamic Q-Res filter self-oscillation scream (scaled by Vel->Q) |
9. Five Pro Sound Design Recipes
1. Kraftwerk Electro Vocals
Crisp, intelligible robotic lead vocals locked tightly to your song's key and tempo grid with subtle analog warmth.
2. 1978 Speak & Spell Dying Battery
Nostalgic letter-by-letter spelling toy sagging in pitch and choking on corrupted ROM bits like a drained 9V battery.
3. Acid 303 Formant Talkbox Vocoder
Feeds an external sawtooth synth, 303 bassline, or drum break directly through the screaming 10-pole Votrax vocal tract.
4. Android Cathedral Poly Choir
Lush 8-voice polyphonic cybernetic choir singing sustained multi-part chords or frozen formant pads.
5. Arcade Boss Stutter Soundboard
Aggressive 1980s coin-op arcade taunts chopped across MIDI pads with rhythmic sustain-pedal ROM freezes.
10. Installation, External Vocoder Routing & Apple Logic Pro Support
Linux (x86_64)
Copy what-you-say.clap to ~/.clap/ and what-you-say.vst3 to ~/.vst3/.
Presets: ~/.local/share/what-you-say/presets/
Windows (x86_64)
Copy what-you-say.clap to C:\Program Files\Common Files\CLAP\ and what-you-say.vst3 to C:\Program Files\Common Files\VST3\.
Presets: %APPDATA%\vanBuffelen\what-you-say\Presets\
macOS Universal2 (AUv2 & CLAP)
Copy what-you-say.component to /Library/Audio/Plug-Ins/Components/ and what-you-say.clap to /Library/Audio/Plug-Ins/CLAP/, then clear Gatekeeper quarantine once:sudo xattr -cr /Library/Audio/Plug-Ins/Components/what-you-say.component
Presets: ~/Library/Audio/Presets/vanBuffelen/what-you-say/
🎹 Built-In On-Screen QWERTY Keyboards for Apple Logic Pro
Apple Logic Pro, GarageBand, and MainStage intercept computer keyboard keys before they reach AUv2 text boxes. Whenever What You Say? runs inside an Apple AU host on macOS, clicking inside Preset Save, the Live Keyboard Lyrics Editor, or the Vox Roll Lyrics Sidebar automatically opens a floating mouse-clickable QWERTY pad (complete with Back, Del Word, - Syll, _ Rest, New Line, and Paste).
External Audio Vocoder Routing (Source = Vocoder)
- Switch
Sourcein VOICE & CHIP fromChiptoVocoder(or load Preset08,12, or25). - Route external carrier audio (sawtooth synth chords, 303 acid lines, drum breaks, or vocals) into the track or sidechain input and set header
Inputfor a healthy signal on theINmeter. - Sequence lyrics in
VOX ROLLor trigger MIDI notes inLIVE KEYBOARD— your external audio now excites the 10-pole LPC vocal tract!
11. Factory Presets Reference (25 Presets)
01–10: Core Live & Bend Showcases
01 Cyber Lyricist, 02 Glitch Chop Soundboard, 03 1978 Speak & Spell, 04 Android Cathedral, 05 Data Bus Short Circuit, 06 Living Larynx Organ, 07 Formant Time Machine, 08 Talking Drum Crusher (Vocoder), 09 Clock Starved Growl, 10 Screaming Lattice Q.
11–20: Vintage Arcade & Electro Classics
11 1982 VLM5030 Taunt, 12 Acid 303 Talkbox (Vocoder), 13 Kraftwerk Autobahn, 14 Intellivision SP0256, 15 Q-Bert SC-01A Alien, 16 Cybernetic Gospel Choir, 17 Glitch Spelling Bee, 18 Haunted Speak & Read, 19 Manual Scrub Pad, 20 Beatbox Larynx.
21–25: Melodic Vox Roll Sequences
21 Cyber Electro Hook (5220), 22 Kraftwerk Robot Arp (0256), 23 Daft Talkbox Lead (SC01), 24 Android Poly Choir (5220 Choir), and 25 Vocoder Groove Singer (6295 Poly Vocoder).
12. Complete 26-Parameter Automation Reference
Every parameter available for DAW automation and MIDI control in What You Say?:
| ID | Parameter Name | Section | Type | Default | Range | Unit | Description |
|---|---|---|---|---|---|---|---|
| work_mode | Workspace Mode | Header | Selector | Vox Roll | Vox Roll, Live Keyboard | — | Selects the active lower workspace and melodic Piano-Roll sequencer vs. direct MIDI trigger engine. |
| in_gain | Input Level | Master I/O | Knob | 0.0 | -24.0 to +24.0 | dB | Excitation and external DAW vocoder sidechain/track input drive. |
| mix | Dry/Wet Mix | Master I/O | Knob | 55.0 | 0% to 100% | % | Parallel balance between intelligible Dry Core speech and mutated Wet Bent twin. |
| out_gain | Output Level | Master I/O | Knob | 0.0 | -24.0 to +12.0 | dB | Master output trim before the -0.1 dBFS brickwall safety limiter. |
| dac_mode | Chip DAC | Voice & Chip | Chip Selector | 5220 | 5220 (TMS5220), 0256 (SP0256-AL2), SC01 (Votrax SC-01A), VLM (Sanyo VLM5030), 6295 (Oki MSM6295) | — | Selects one of the 5 vintage speech chip & DAC architectures. |
| base_tune | Tune | Voice & Chip | Knob | 0.0 | -24.0 to +24.0 | st | Semitone pitch offset relative to played MIDI or sequenced Vox Roll notes. |
| speech_speed | Speed | Voice & Chip | Knob | 1.00x | 0.25x to 2.50x | ratio | LPC frame rate multiplier (or musical division 1/1..1/16 when Tempo Sync = Grid). |
| glottal_grunge | Grunge | Voice & Chip | Knob | 8.0 | 0% to 100% | % | Glottal pulse rasp, sub-harmonic edge, and vocal breathiness. |
| scrub_pos | Scrub | Voice & Chip | Knob | 0.0 | 0% to 100% | % | Manual formant frame scrub position inside the active word when Freeze is enabled. |
| audio_source | Source | Voice & Chip | Selector | Chip | Chip, Vocoder | — | Switches excitation between internal vintage chip oscillators and external DAW track/sidechain audio. |
| voice_mode | Voices | Voice & Chip | Selector | Poly | Mono, Poly (8-Voice), Choir | — | Selects 1-voice mono lead, 8-voice polyphonic chords, or lush stereo-detuned unison choir. |
| tempo_sync | Tempo Sync | Voice & Chip | Cycle Button | Off | Off, BPM, Grid | — | Scales speech speed to host BPM or locks word stepping to musical subdivisions. |
| legato_glide | Glide | Voice & Chip | Toggle | Off | Off / On | — | Enables smooth pitch and vocal-tract formant portamento on overlapping notes. |
| freeze_scrub | Freeze | Voice & Chip | Toggle | Off | Off / On | — | Freezes automatic LPC frame advance for manual knob or Modwheel formant scrubbing. |
| live_mode | Live Mode | Live Mode | Tab Selector | Stepper | 1 · Phrase Stepper, 2 · Word Pads, 3 · ROM Glitch, 4 · Phoneme Organ | — | Active MIDI Note-On trigger submode when Workspace = Live Keyboard. |
| spell_mode | Spell A-Z | Lyrics | Toggle | Off | Off / On | — | Orthogonal toggle that spells every word character-by-character (1978 Speak & Spell style). |
| clock_starve | Clock | Circuit Bends | Knob | 0.0 | -24.0 to +24.0 | st | Underclocks or overclocks the Wet chip sample rate & formants (modulated live by Pitchbend). |
| bit_flip | Bit-Flip | Circuit Bends | Knob | 0.0 | 0% to 100% | % | Binary XOR ROM bit corruption across active D0..D9 data-bus pins (modulated live by Modwheel). |
| q_overload | Q-Res | Circuit Bends | Knob | 8.0 | 0% to 100% | % | Pushes 10-pole lattice reflection coefficients toward acid-like resonant self-oscillation. |
| vel_to_q | Vel->Q | Circuit Bends | Knob | 25.0 | 0% to 100% | % | Scales how strongly MIDI Velocity and Aftertouch boost Q-Res. |
| bit_flip_mode | XOR Bus | Circuit Bends | Selector | Vowel K1-4 | Vowel K1-4, Throat K5-10, All K1-10 | — | One-click preset masks for the D0..D9 reflection stage data bus. |
| stutter_hold | Stutter | Stutter | Toggle | Off | Off / On | — | Freezes and loops the active LPC ROM frame address (also Sustain Pedal CC64 / Keyswitch C#0). |
| sync_wet_pointer | Sync Wet | Stutter | Toggle | On | Off / On | — | Resynchronizes the Wet frame pointer to the Dry pointer upon releasing Stutter. |
| stutter_loop_size | Size | Stutter | Knob | 2 | 1 to 8 | frames | Number of LPC frames captured inside the frozen Address Stutter loop. |
| stutter_rate | Rate | Stutter | Knob | 1.00x | 0.25x to 4.00x | ratio | Playback speed multiplier of the frozen stutter loop. |
| frame_jitter | Jitter | Stutter | Knob | 0.0 | 0% to 100% | % | Injects stochastic ROM frame-clock timing instability. |
