Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
9155b4f
Plan the Radiohead family
claude Aug 15, 2026
9e19122
Add the multi-head tape echo: tap.tapecho~
claude Aug 15, 2026
16ab2b5
Note the tape echo's Max slice in the family plan
claude Aug 15, 2026
01f2398
Add the live stutter rig: tap.stammer~
claude Aug 15, 2026
a150615
Note the stutter rig's Max slice in the family plan
claude Aug 15, 2026
1e04e65
Write the Radiohead-family chapters
claude Aug 16, 2026
4358a54
Record the Ondes Martenot source hunt
claude Aug 16, 2026
c146589
Add the two-stage fuzz: tap.fuzz~
claude Aug 16, 2026
d05a654
Finish the fuzz verification layer, and correct the oversampling claim
claude Aug 16, 2026
a202550
Open the Ondes gate: all three papers read
claude Aug 16, 2026
b72b80c
Write the fuzz chapters
claude Aug 16, 2026
71d2592
Design tap.ondes~ against the sources
claude Aug 16, 2026
c4e2622
Add the Ondes intensity key: tap.touche~
claude Aug 16, 2026
a9e45ed
Add the Ondes diffuseurs and the granular scrub
tap Aug 17, 2026
01a280f
Add the Ondes Martenot voice: the triode stages and the heterodyne so…
tap Aug 17, 2026
8601f9a
Give the ondes voice a signal-rate performance path
tap Aug 17, 2026
d5a4ade
Propagate the ondes voice's smoothing to its intensity key
tap Aug 17, 2026
6b3e0cb
book: six chapters for the scrub, the diffuseurs and the Ondes
claude Aug 17, 2026
07f927e
Sort the umbrella header's includes
claude Aug 17, 2026
f1ebdfc
Retract the pitchaccum cancellation, and file what survives
claude Aug 17, 2026
2785d24
Cascade the fuzz oversampler, and correct a default drawn from one tone
claude Aug 17, 2026
8b15302
Add three Radiohead-family recipes, and record the register source hunt
claude Aug 17, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 15 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,10 @@ header adds no nested namespace, the class) the kernel lives in.
| `overdrive.h` | `tap.overdrive~` | LGW-voiced feedback overdrive (`tap::tools::od`) |
| `vca.h` | `tap.vca~` | Voltage-controlled amplifier (`tap::tools::vca`) |
| `adsr.h` | `tap.adsr~` | Virtual-analog ADSR envelope, legacy Jamoma curves as modes (`tap::tools::adsr`) |
| `fuzz.h` | `tap.fuzz~` | Two-stage tone-stacked fuzz on the DAFx-07 cascade (`tap::tools::fuzz`) |
| `touche.h` | `tap.touche~` | The Ondes Martenot intensity key as a published gain law (`tap::tools::touche`) |
| `diffuseur.h` | `tap.metallique~`, `tap.palme~` | The Ondes diffuseurs as driven resonators (`tap::tools::diffuseur`) |
| `ondes.h` | `tap.ondes~`, `tap.triode~` | The Ondes Martenot voice: heterodyne detector and load-line triode stages (`tap::tools::ondes`) |

**Voices, drums, and sequencing**

Expand Down Expand Up @@ -82,6 +86,9 @@ header adds no nested namespace, the class) the kernel lives in.
| `discreet.h` | `tap.discreet~` | *Discreet Music* two-machine regeneration loop (`tap::tools::discreet`) |
| `airport.h` | `tap.airport~` | *Music for Airports* incommensurate loop bank (`tap::tools::airport`) |
| `garden.h` | `tap.garden~` | Generative event loop on the Bloom principle (`tap::tools::garden`) |
| `tapecho.h` | `tap.tapecho~` | Multi-head tape echo (`tap::tools::tapecho`) |
| `stammer.h` | `tap.stammer~` | Live buffer-stutter rig (`tap::tools::stammer`) |
| `scrub.h` | `tap.scrub~` | Granular scrub over live capture (`tap::tools::scrub`) |

`taptools.h` is the umbrella header that pulls in every kernel above. `stft.h`, `tune.h`,
`harmonizer.h` and `conv_engine.h` reach into `tap::dsp` (the pinned DspTap submodule) for the
Expand All @@ -92,7 +99,7 @@ Plus, all Max-free:
- **`tests/`** — Catch2 unit tests for the kernels (fetched via FetchContent; run with `ctest`).
Wrapper-level tests (attributes, Min plumbing) stay with the externals on the min-api harness
in the Max package.
- **`tools/render/`** — offline WAV renderers (`diode_render`, `tb303_render`, `ladder_render`, `vco_render`,
- **`tools/render/`** — offline WAV renderers (`diode_render`, `tb303_render`, `ladder_render`, `vco_render`, `radiohead_render`,
`grm_comb_render`, `grm_pitchaccum_render`, `autowah_render`) for listening checks outside Max.
- **`tools/capi/`** — a small C ABI (`taptools_capi`) over a *subset* of the kernels, for the
notebooks and other non-C++ consumers. `tools/capi/taptools_capi.h` is the authoritative list of
Expand All @@ -106,10 +113,13 @@ Plus, all Max-free:
- **`bench/`** — CPU benchmarks and the per-machine regression ratchet (see `bench/README.md`).
- **`book/`** — *Tools on Tap*, the mdBook field guide (the AmbiTap/SampleRateTap/MuTap book
pattern): one chapter per object family, every claim measured by the notebooks/tests. Built
and published to Pages by `.github/workflows/docs.yml`. Fourteen user-facing chapters across seven
parts — sources (`vco`), filters (`svf`, `ladder`, `autowah`), strings/rooms/spirals
(`convolve`, `5comb`, `pitchaccum`), the spectral set (`vocoder`, `nr`, `spectra`), the rhythm
section (`acid`, `drums`), staying in tune (`tune`), the pedalboard (`overdrive`) — plus
and published to Pages by `.github/workflows/docs.yml`. Twenty-four user-facing chapters across
nine parts — sources (`vco`), filters (`svf`, `ladder`, `autowah`), strings/rooms/spirals
(`convolve`, `5comb`, `pitchaccum`), tape and time (`discreet`, `airport`, `garden`,
`components`), the machines you ride (`tapecho`, `stammer`, `fuzz`, `scrub`, `diffuseurs`,
`ondes`), the spectral set (`vocoder`, `nr`, `spectra`), the rhythm
section (`acid`, `drums`), staying in tune (`tune`), the pedalboard (`overdrive`) — plus a
recipes part of whole patches, and
**"The machine, file by file"**: one deep-dive appendix per kernel header
(SampleRateTap-style) deriving the math, reviewing the code, and recording why each
algorithm is built the way it is.
Expand Down
263 changes: 263 additions & 0 deletions book/PLAN-ondes.md

Large diffs are not rendered by default.

329 changes: 329 additions & 0 deletions book/PLAN-radiohead-chapters.md

Large diffs are not rendered by default.

475 changes: 475 additions & 0 deletions book/PLAN-radiohead-family.md

Large diffs are not rendered by default.

Loading
Loading