ReaSampler

A native C++ REAPER extension that captures any arbitrary audio source into a per-project sample bank (cached files + a docked grid), decoupled from the arrange view, with keyboard/MIDI-bindable capture and placement. Built as a precision tool: deterministic, non-destructive, no clutter.

This is a skeleton: the loading contract, build system, and the testable pure-core library are wired up. The bank panel, capture backend, and remaining module set are stubbed with clearly marked seams.

Layout

src/main.cpp            The REAPER<->extension contract: the single file that
                        #defines REAPERAPI_IMPLEMENT, resolves API pointers,
                        and holds the action-registration seam (commented,
                        ready to reinstate under the CEREBELLUM_REASAMPLER_
                        prefix). Logs "ReaSampler loaded." on startup.
src/bank_model.{h,cpp}  Pure, REAPER-free core: the Sample metadata struct and
                        BankIndex (add / remove / query / tier moves /
                        dedup-by-hash + JSON round-trip). This is the heart;
                        everything else hangs off it. Currently an M0
                        placeholder — the full implementation is Milestone 1.
tests/test_bank_model.cpp  Standalone tests for bank_model — no REAPER needed.
vendor/                 git submodules go here (see below).

Target module set (milestones ahead — see PLAN.md):

bank_model   Sample metadata + BankIndex + JSON (pure)
peaks        Waveform min/max bins from raw PCM (pure)
capture      ICaptureBackend: OfflineRenderBackend + RealtimeRecordBackend
insert       InsertMedia-based placement (explicit tempo-conform flag)
bank_panel   Docked LICE-drawn grid: thumbnails, audition, multi-select
persist      Project ext state <-> bank_model JSON; project-relative paths
actions      Bindable capture / placement / slot action family

One-time setup

git submodule update --init

Vendors two submodules:

• vendor/reaper-sdk — sdk/reaper_plugin.h, sdk/reaper_plugin_functions.h, SWELL headers
• vendor/WDL — WDL utilities and the SWELL cross-platform Win32 layer

Build

cmake -B build -S .
cmake --build build

Targets:

• bank_model_tests — run with ctest --test-dir build (or run the binary). This is your fast loop: iterate the pure core without touching REAPER.
• reaper_reasampler — the extension binary.

macOS / Linux dialog resources

When bank_panel is added (Milestone 5), resource.rc will need SWELL's resgen once (Win32 compiles it directly). Generate the SWELL dialog source and add it to the non-Windows build:

php vendor/WDL/WDL/swell/mac_resgen.php src/resource.rc   # macOS
# (Linux uses the same generated output.)

Then add the generated file to the APPLE / Linux target_sources blocks in CMakeLists.txt. The SWS extension's build is the canonical reference if you get stuck here — it's the fiddliest step and only bites once.

Install / test

Copy the built binary into REAPER's UserPlugins/ folder (Options -> Show REAPER resource path), then restart REAPER (extensions load at startup; there is no hot reload). The extension logs "ReaSampler loaded." to the REAPER console on startup; no actions are registered yet.

Debug by attaching your debugger to the REAPER process. ShowConsoleMsg is a quick printf.

Where to build next

See PLAN.md for the full milestone roadmap and TODO.md for the near-term slice. The current first work is Milestone 1 — flesh out bank_model: define the full Sample field set, implement BankIndex (add / remove / query / tier / dedup), add JSON serialize/deserialize, and drive it all through the existing CTest harness.