
A weapon sound is nearly always two sounds: the action and the impact. Generate them separately and layer.
Every clip shows the exact prompt that produced it. The render script reads its prompts from the same file as this page. Copy one, change a word and generate your own.
pump-action shotgun firing outdoors, sharp percussive blast with a wide crack and a distant echo
pump-action shotgun being racked, heavy metal slide with a shell chambering, close mic, dry
automatic machine gun firing a long burst, rapid heavy reports with brass shells hitting concrete
steel sword drawn from a leather scabbard, long metallic ring with a bright edge, close mic
two steel swords clashing, sharp metallic ring with sparks and a sustained shimmer, medium hall
crossbow firing, taut string release with a wooden thunk and the bolt whistling away
thrown spear whistling through air and thudding into a wooden shield, splintering wood, outdoor space
knife stabbing into flesh, wet visceral impact with a short blade scrape, close and dry
revolver hammer being cocked, three precise mechanical clicks, very close mic, completely dry
grenade pin pulled with a metallic ping, lever springing off, then the grenade tumbling onto gravel
These models respond to physical description. Name the material, the action and the space.
metal sword slash through air, thin blade whoosh, sharp doppler snap, close mic, dry, 300 ms
"Doppler snap" separates a blade cutting air from a generic whoosh. A thin edge moving fast produces a distinct pitch snap that plain "whoosh" does not.
single pistol gunshot, sharp crack, tight muzzle report, short natural decay, close mic, minimal room tone
"Minimal room tone" keeps the shot dry so you can add a separate tail or echo yourself. Reverb baked in here cannot be removed later.
rifle magazine reload, metal clicks and a solid mechanical slide, close mic, dry, sequential mechanical sounds, 1 second
"Sequential mechanical sounds" tells the model this is several separate actions in order. A reload that collapses into one blended clank sounds wrong.
bow string release, taut string snap followed by a thin fast whoosh, close mic, dry, 400 ms
"Snap followed by whoosh" follows the two stages of a real bow: the string releases, then the arrow moves. The model needs that order spelled out.
metal weapon striking a shield, hard clang, bright metallic ring with short sustain, close mic, small room reflection
"Short sustain" limits the ring so it sounds like a solid parry. A long ring makes a block sound like a struck bell.
Almost no weapon effect is a single event. A sword swing is a whoosh plus, sometimes, a clash on contact. A gunshot is a crack plus a mechanical action plus an optional impact. Generate the action (swing, trigger pull, string release) and the result (clash, shot, impact) separately and layer them in your editor or engine. One prompt asked to do both tends to blend the two events into one mushy sound.
"Gun sound" is a category with hundreds of correct answers. "Sharp crack, tight muzzle report, short natural decay" describes the mechanism of a shot and narrows the model to one family of results. Do the same for melee and mechanical sounds: "metal clicks and a solid mechanical slide" works better than "reload sound" because it names the parts that move.
The same swing sounds different on metal, flesh or wood. A strike on a shield rings; a strike on a body thuds and dies fast. State the target material ("soft target, no metallic ring" or "metal shield, bright ring"), since it changes the whole spectral shape of the impact.
The models run on your machine, which changes the cost, the privacy and what you can automate.
Weights are fetched once. After that, generation, the library and the API all work with the network off. Everything lives in one SQLite file and one folder of WAVs under ~/.soundbox, and nothing is uploaded.
Soundbox runs an MCP server in the same process, with tools for generating and listing sounds. Generated files come back as absolute paths, so an agent can copy them into a project.
Every model's terms are shown before you download it, and non-commercial weights need an explicit confirmation. Soundbox is MIT. The licence of the model that made a sound governs what you may do with it.
claude mcp add --transport http soundbox http://127.0.0.1:17494/mcpcurl -X POST http://127.0.0.1:17494/api/generate \
-H 'Content-Type: application/json' \
-d '{"model":"audiocpp-stable-audio-3-sfx","prompt":"8-bit coin pickup blip","duration_s":1}'