Ears for coding agents: let AI hear, review and make sound. CPU-only, open source.
kit presets: fitted CC0 sounds where they measure closer to the role; notes state measured facts
Leonxlnx31279351236f
diff --git a/earshot/forge/kits/calm.json b/earshot/forge/kits/calm.jsonindex 48b43d4..2a1621e 100644--- a/earshot/forge/kits/calm.json+++ b/earshot/forge/kits/calm.json@@ -2,10 +2,10 @@"kit": 1,"name": "calm","sr": 48000,- "note": "The default for text-led films: soft natural touches, one tuned voice for bells and text, gentle air for moves, a single struck note for the lockup. Members come from the families listeners took for recordings in earshot's blind test (taps, struck bells; the pluck is the launch film's measured kalimba) and pass the model-free audit (earshot kit check). Riser, swell, suck and drop are off: a reveal resolves on one element.",+ "note": "The default for text-led films: soft natural touches, one tuned voice for bells and text, gentle air for moves, a single struck note for the lockup. Clicks, ticks, the pop, the snap, the space bar and the short whoosh are CC0 recordings fitted as code, where they measure closer to their role than the forge member (earshot match against the role's description and against synth-blip descriptions, earshot realness); the other touches are forge taps, the tuned voice is the launch film's measured kalimba. Every take passes the model-free audit (earshot kit check). Riser, swell, suck and drop are off: a reveal resolves on one element.","roles": {- "tick": {"sound": "tap/glass", "takes": 3, "align": "onset", "level_db": -8.0,- "note": "a light fingertip on glass (80 ms tail, 466 Hz centroid): the tap family read as recorded in the blind test, where designed hover ticks were picked out"},+ "tick": {"sound": "fit/tick/domino", "takes": 3, "align": "onset", "level_db": -5.0,+ "note": "domino pieces knocking, a CC0 recording fitted as code (0.14 s): matches 'a soft quiet UI tick' at z +1.02, p 0.67 over synth-blip descriptions (tap/glass: -0.08, p 0.01), realness 0.83 (0.45); level +3 dB for its lower loudness at the same peak"},"tick.crisp": {"sound": "pro_tap/glass", "takes": 3, "align": "onset", "level_db": -8.0,"note": "the same glass touch, tighter (98 ms, 225 Hz body + glass partial): crisp without a synthetic tink"},"tock": {"sound": "tap/knuckle", "takes": 3, "align": "onset", "level_db": -6.0,@@ -16,10 +16,10 @@"note": "a round low thump (75 Hz body, 0.18 s): an element settling, felt more than heard"},"land.light": {"sound": "tap/soft", "takes": 3, "align": "onset", "level_db": -8.0,"note": "a soft fingertip thump for small elements landing"},- "pop": {"sound": "pro_pop_in/airy", "takes": 4, "align": "onset", "level_db": -6.0,- "note": "an airy pop-in thump with no pitch glide: tonal pops risk the 8-bit read"},- "whoosh.short": {"sound": "swipe/velvet", "takes": 3, "align": "peak", "level_db": -7.0,- "note": "a velvet swipe: dark cloth air (227 Hz centroid), one smooth pass, no whistle"},+ "pop": {"sound": "fit/pop/mouth_plop", "takes": 4, "align": "onset", "level_db": -2.5,+ "note": "a soft mouth plop, a CC0 recording fitted as code (0.28 s), no pitch glide: matches 'a soft natural pop' at z +2.98, p 1.00 over synth-blip descriptions (pro_pop_in/airy: +1.88, 0.98), realness 0.97 (0.65)"},+ "whoosh.short": {"sound": "fit/whoosh.short/bamboo_swish", "takes": 3, "align": "peak", "level_db": -9.0,+ "note": "a short whoosh, a CC0 recording fitted as code (0.48 s, one smooth pass): matches 'a short fast whoosh swish through the air' at z +5.32 (swipe/velvet, which reads as 'a heavy thud': +2.01), realness 0.99 (0.97)"},"whoosh.long": {"sound": "whoosh_big/swell", "takes": 2, "align": "peak", "level_db": -7.0,"note": "a gentle air swell (1.36 s, peak at 0.44 s) for scene moves: air, not a sub-led designed whoosh"},"suck": null,@@ -27,16 +27,16 @@"drop": null,"key": {"sound": "typing_key/thock", "takes": 12, "align": "onset", "level_db": -10.0,"note": "a thocky mechanical key, a new take per keystroke; the light / laptop members ring (comb ring in the audit)"},- "key.space": {"sound": "typing_key/deep", "takes": 4, "align": "onset", "level_db": -9.0,- "note": "the deeper, longer cap (982 Hz centroid) stands in for the space bar"},+ "key.space": {"sound": "fit/key.space/thock_space", "takes": 4, "align": "onset", "level_db": -9.5,+ "note": "a mechanical keyboard space bar, a CC0 recording fitted as code (0.39 s): matches 'a spacebar press' at z +3.22 (typing_key/deep: +2.14), realness 0.99 (0.84); its own top tags include 'a spacebar press'"},"key.return": {"sound": "typing_key/deep", "takes": 2, "seed": 4100, "align": "onset", "level_db": -7.0,- "note": "the deep cap pressed firmer: return lands 2 dB over the space bar"},- "click": {"sound": "tap/finger", "takes": 2, "align": "onset", "level_db": -8.0,- "note": "a fingertip tap for cursor presses: listeners picked the designed clicks out in the blind test"},+ "note": "the deep cap pressed firmer (its own seed): return sits 2.5 dB over the space bar"},+ "click": {"sound": "fit/click/floss_lid", "takes": 2, "align": "onset", "level_db": -4.5,+ "note": "a small plastic click, a CC0 recording fitted as code (0.13 s, 4.9 kHz centroid): matches 'a soft UI button click' at z +1.70, p 0.73 over synth-blip descriptions (tap/finger, which reads as 'a punchy impact hit': +1.37, 0.61), realness 0.97 (0.89)"},"click.confirm": {"sound": "pluck/kalimba_soft", "takes": 1, "seed": 8101, "edits": {"pitch": "C6"}, "align": "onset", "level_db": -10.0,"note": "a soft tuned pluck confirms: the same voice as bell and text, quieter"},- "snap": {"sound": "pro_pop_in/knock", "takes": 2, "align": "onset", "level_db": -6.0,- "note": "a firm short knock for a lock-in (one attack); toggles were picked out in the blind test"},+ "snap": {"sound": "fit/snap/switch_flip", "takes": 2, "align": "onset", "level_db": -3.5,+ "note": "a switch flip, a CC0 recording fitted as code (0.19 s, one attack): matches 'a toggle switch click' at z +2.24, p 1.00 over synth-blip descriptions (pro_pop_in/knock: +0.61, 0.27), realness 0.97 (0.08)"},"swell": null,"bell": {"sound": "pluck/kalimba", "pitches": ["C5", "D5", "E5", "G5", "A5"], "takes": 1, "align": "onset", "level_db": -5.0,"note": "the launch film's kalimba on a C pentatonic: one tuned note per progress step or motif note"},diff --git a/earshot/forge/kits/crisp.json b/earshot/forge/kits/crisp.jsonindex c33ea9b..b845c5f 100644--- a/earshot/forge/kits/crisp.json+++ b/earshot/forge/kits/crisp.json@@ -2,10 +2,10 @@"kit": 1,"name": "crisp","sr": 48000,- "note": "Energetic dev-tool and product films: tight UI ticks and clicks, fast air for moves, one clean gated hit, a short tuned sub drop. Designed members where the idiom is designed (UI clicks, the gated hit), natural taps elsewhere; every member passes the model-free audit. Riser, swell and suck are off.",+ "note": "Energetic dev-tool and product films: tight UI ticks and clicks, fast air for moves, one clean gated hit, a short tuned sub drop. Designed members where the idiom is designed (the crisp tick, the gated hit, the sub drop, the bell and confirm dings); clicks, ticks, keys, the snap and the light touches are CC0 recordings fitted as code, where they measure closer to their role than the forge member. Every take passes the model-free audit. Riser, swell and suck are off.","roles": {- "tick": {"sound": "tap/glass", "takes": 3, "align": "onset", "level_db": -8.0,- "note": "a light glass touch: natural ticks for counters and list rows"},+ "tick": {"sound": "fit/tick/domino", "takes": 3, "align": "onset", "level_db": -5.0,+ "note": "domino pieces knocking, a CC0 recording fitted as code (0.14 s): matches 'a soft quiet UI tick' at z +1.02, p 0.67 over synth-blip descriptions (tap/glass: -0.08, p 0.01), realness 0.83 (0.45)"},"tick.crisp": {"sound": "pro_click/tink", "takes": 3, "align": "onset", "level_db": -10.0,"note": "a bright designed tink (37 ms, single attack): the precise UI tick; keep it quiet"},"tock": {"sound": "tap/knuckle", "takes": 3, "align": "onset", "level_db": -6.0,@@ -14,8 +14,8 @@"note": "one clean gated hit: a single attack, no build (pre-swell 10 ms), 0.67 s; nothing layered on it"},"land": {"sound": "pro_pop_in/deep", "takes": 3, "align": "onset", "level_db": -4.0,"note": "a round low thump for heavier elements landing"},- "land.light": {"sound": "pro_tap/knock", "takes": 3, "align": "onset", "level_db": -7.0,- "note": "a tight knock (86 ms) for small elements landing"},+ "land.light": {"sound": "fit/land.light/fingertip_book", "takes": 3, "align": "onset", "level_db": -7.0,+ "note": "light finger steps on a book, a CC0 recording fitted as code (0.38 s): matches 'a soft finger tap on wood' at z +2.07, p 0.99 over synth-blip descriptions (pro_tap/knock: +0.13, p 0.00), realness 0.95 (0.28)"},"pop": {"sound": "pro_pop_in/round", "takes": 4, "align": "onset", "level_db": -6.0,"note": "a round pop-in thump, no pitch glide: runs of pop-ins stay out of the 8-bit read"},"whoosh.short": {"sound": "whoosh_fast/tight", "takes": 3, "align": "peak", "level_db": -6.0,@@ -26,23 +26,23 @@"riser": null,"drop": {"sound": "pro_sub_drop/quick", "takes": 1, "align": "onset", "level_db": -4.0,"note": "the shortest designed sub drop (1.0 s, blooms 110 ms after the cut); set edits.pitch to the film's root (G1-C2)"},- "key": {"sound": "typing_key/crisp", "takes": 12, "align": "onset", "level_db": -10.0,- "note": "a crisp mechanical key, a new take per keystroke"},- "key.space": {"sound": "typing_key/thock", "takes": 4, "align": "onset", "level_db": -9.0,- "note": "the bigger thocky cap stands in for the space bar"},+ "key": {"sound": "fit/key/medium", "takes": 12, "align": "onset", "level_db": -11.0,+ "note": "one mechanical key, press and release, a CC0 recording fitted as code (0.43 s, 2.2 kHz centroid: brighter than typing_key/crisp at 0.6 kHz), a new take per keystroke: matches 'a single mechanical keyboard key press' at z +4.65 (typing_key/crisp: +4.48), realness 0.99 (0.95)"},+ "key.space": {"sound": "fit/key.space/thock_space", "takes": 4, "align": "onset", "level_db": -9.0,+ "note": "a mechanical keyboard space bar, a CC0 recording fitted as code (0.39 s): matches 'a spacebar press' at z +3.22 (typing_key/thock: +2.59), realness 0.99 (0.96)"},"key.return": {"sound": "typing_key/clicky", "takes": 2, "align": "onset", "level_db": -7.0,"note": "a clicky switch for return: brighter and firmer than the run"},- "click": {"sound": "pro_click/mouse", "takes": 2, "align": "onset", "level_db": -7.0,- "note": "a mouse-button click (54 ms, 1.1 kHz centroid): the cursor press"},+ "click": {"sound": "fit/click/floss_lid", "takes": 2, "align": "onset", "level_db": -4.5,+ "note": "a small plastic click, a CC0 recording fitted as code (0.13 s, 4.9 kHz centroid): matches 'a soft UI button click' at z +1.70, p 0.73 over synth-blip descriptions (pro_click/mouse: +1.03, 0.35), realness 0.97 (0.06)"},"click.confirm": {"sound": "pro_notify/ding_2045", "takes": 1, "align": "onset", "level_db": -9.0,"note": "a short clean ding (0.36 s) for a confirmed action"},- "snap": {"sound": "toggle/latch", "takes": 2, "align": "onset", "level_db": -6.0,- "note": "press and latch: the designed lock-in (two attacks by design; snap is not a hit role)"},+ "snap": {"sound": "fit/snap/switch_flip", "takes": 2, "align": "onset", "level_db": -6.5,+ "note": "a switch flip, a CC0 recording fitted as code (0.19 s, one attack): matches 'a toggle switch click' at z +2.24, p 1.00 over synth-blip descriptions (toggle/latch, two attacks: +2.04, 0.97), realness 0.97 (0.50)"},"swell": null,"bell": {"sound": "pluck/kalimba", "pitches": ["C5", "D5", "E5", "G5", "A5"], "takes": 1, "align": "onset", "level_db": -5.0,"note": "the tuned kalimba voice on a C pentatonic: progress steps and motifs"},- "text": {"sound": "pro_tap/soft", "takes": 3, "align": "onset", "level_db": -12.0,- "note": "a soft thump when a text fragment resolves, untuned so it never fights the music"}+ "text": {"sound": "fit/land.light/finger_phone", "takes": 3, "align": "onset", "level_db": -5.0,+ "note": "a finger tapping a phone, a CC0 recording fitted as code (0.33 s, a low soft tap, untuned so it never fights the music): its top tag is 'a soft UI button tap'; realness 0.89 (pro_tap/soft, which it replaces, is a designed thump); level +7 dB for its lower loudness at the same peak (95 Hz centroid)"}},"off": {"suck": "off by default: a reverse whoosh into a cut stacks a build onto the reveal",diff --git a/earshot/forge/kits/minimal.json b/earshot/forge/kits/minimal.jsonindex 67c870f..bfc06ae 100644--- a/earshot/forge/kits/minimal.json+++ b/earshot/forge/kits/minimal.json@@ -2,7 +2,7 @@"kit": 1,"name": "minimal","sr": 48000,- "note": "Designed, sub-led, effects-only films (no music bed): airy digital ticks, low sub swells for moves, one sub-led hit, the designed sub drop, high-passed key ticks. Every member passes the model-free audit. Riser, swell and suck are off.",+ "note": "Designed, sub-led, effects-only films (no music bed): airy digital ticks, low sub swells for moves, one sub-led hit, the designed sub drop, high-passed key ticks. The light touch, the text touch and the snap are CC0 recordings fitted as code: the designed taps and knock they replace read as synth blips to earshot match (p 0.01-0.27 for their role against synth-blip descriptions). Every take passes the model-free audit. Riser, swell and suck are off.","roles": {"tick": {"sound": "pro_hover_tick/soft", "takes": 3, "align": "onset", "level_db": -10.0,"note": "an airy digital tick (32 ms): cursor blinks and counters; the air / glass members click in the audit"},@@ -14,8 +14,8 @@"note": "one sub-led gated hit: a single attack, 0.85 s, the weight below 150 Hz; nothing layered on it"},"land": {"sound": "pro_pop_in/deep", "takes": 3, "align": "onset", "level_db": -5.0,"note": "a low round thump (75 Hz body)"},- "land.light": {"sound": "pro_tap/finger", "takes": 3, "align": "onset", "level_db": -8.0,- "note": "a fingertip touch for small elements"},+ "land.light": {"sound": "fit/land.light/fingertip_book", "takes": 3, "align": "onset", "level_db": -7.5,+ "note": "light finger steps on a book, a CC0 recording fitted as code (0.38 s, 240 Hz centroid: it sits under sub-led sounds): matches 'a soft finger tap on wood' at z +2.07, p 0.99 over synth-blip descriptions (pro_tap/finger: +0.69, p 0.01), realness 0.95 (0.16)"},"pop": {"sound": "pro_pop_in/round", "takes": 4, "align": "onset", "level_db": -7.0,"note": "a round pop-in thump, no pitch glide"},"whoosh.short": {"sound": "whoosh_fast/heavy", "takes": 3, "align": "peak", "level_db": -7.0,@@ -36,13 +36,13 @@"note": "a soft designed UI click (53 ms)"},"click.confirm": {"sound": "pro_notify/ding_1822", "takes": 1, "align": "onset", "level_db": -10.0,"note": "a short clean ding (0.26 s)"},- "snap": {"sound": "pro_pop_in/knock", "takes": 2, "align": "onset", "level_db": -6.0,- "note": "a firm short knock for a lock-in"},+ "snap": {"sound": "fit/snap/switch_flip", "takes": 2, "align": "onset", "level_db": -3.5,+ "note": "a switch flip, a CC0 recording fitted as code (0.19 s, one attack): matches 'a toggle switch click' at z +2.24, p 1.00 over synth-blip descriptions (pro_pop_in/knock: +0.61, 0.27), realness 0.97 (0.08)"},"swell": null,"bell": {"sound": "pro_notify/ding_1822", "pitches": ["F6", "G6", "A6", "C7", "D7"], "takes": 1, "align": "onset", "level_db": -8.0,"note": "the clean ding on an F pentatonic around its own pitch (1822 Hz): sparse designed notes, no ringing bell"},- "text": {"sound": "pro_tap/finger", "takes": 3, "seed": 5200, "align": "onset", "level_db": -13.0,- "note": "a quiet touch when a text fragment resolves"}+ "text": {"sound": "fit/land.light/finger_phone", "takes": 3, "align": "onset", "level_db": -8.0,+ "note": "a finger tapping a phone, a CC0 recording fitted as code (0.33 s, a quiet low tap): its top tag is 'a soft UI button tap'; realness 0.89 (pro_tap/finger: 0.16); level +5 dB for its lower loudness at the same peak"}},"off": {"suck": "off by default: a reverse whoosh into a cut stacks a build onto the reveal",diff --git a/tests/test_sfx_kit.py b/tests/test_sfx_kit.pyindex d567730..fed889e 100644--- a/tests/test_sfx_kit.py+++ b/tests/test_sfx_kit.py@@ -2,6 +2,7 @@plus the MCP tool functions of the sound bank. Synthetic signals and short bank sounds only; no models."""import jsonimport os+import reimport numpy as npimport pytest@@ -100,6 +101,28 @@ def test_presets_are_valid_restrained_and_explained():assert len(files) == len(set(files))+LISTENING_WORDS = re.compile(r'listener|blind test|picked out|taken for recordings|heard as|to the ear', re.I)+++def test_presets_reference_bank_sounds_and_state_measured_facts():+ """every preset sound is in the bank (forge, pluck or fit); notes describe the sound and what was measured,+ never a listening test as a rule"""+ ids = set(bank.ids())+ fits = 0+ for name in kit.presets():+ k = kit.preset(name)+ notes = [k.get('note', '')] + list((k.get('off') or {}).values())+ for role, spec in k['roles'].items():+ if not spec:+ continue+ assert spec['sound'] in ids, (name, role, spec['sound'])+ fits += spec['sound'].startswith('fit/')+ notes.append(spec['note'])+ bad = [n for n in notes if LISTENING_WORDS.search(n)]+ assert not bad, (name, bad)+ assert fits >= 6 # the presets use the shipped fits where the comparison favoured them++def _tiny(**edit):k = {'kit': 1, 'name': 'tiny', 'sr': 48000,'roles': {'tick': {'sound': 'tap/finger', 'takes': 2, 'level_db': -6.0},