home/ atoms/ sonicpi-bundled-names-validation

Sonic Pi synth, sample, and fx names must exist in the bundled set; names like :kick, :bass, :verb are errors — the real names are :bd_haus, :tb303, :reverb

Sonic Pi ships with a fixed bundled library of synths, sample banks, and effects. Names that sound intuitive (:kick, :bass, :verb) do not exist; the actual identifiers are :bd_haus, :tb303, :reverb, etc. Using a non-existent name raises a runtime error (or silent failure for samples). This is the most common error when porting patterns from other frameworks or writing from intuition. Validation requires checking the names/ directory files: synths.txt, samples.txt, and fx.txt. Also: :beep is the default synth and is aliased as :sine.

Examples

sample :kick — error. sample :bd_haus — correct. synth :bass — error. synth :tb303 — correct. with_fx :verb — error. with_fx :reverb — correct.

Assessment

List the correct Sonic Pi names for: a standard bass drum, a TB-303 style synth, and a reverb effect. Explain how to validate an unknown name before using it in a set.

“**A name must exist in the bundled set.**”
context/ · L1-instruments/sonicpi/gotchas.md · chunk 1