Leonxlnx/earshot

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/Leonxlnx/earshot.svg?style=card)](https://bestofgithub.dev/repo/Leonxlnx/earshot)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/Leonxlnx/earshot.svg)](https://bestofgithub.dev/repo/Leonxlnx/earshot)

Loading README…

command	what an agent gets
`describe FILE`	what it sounds like: calibrated tags (z) with the closest alternative readings, AudioSet labels, measurements
`match FILE QUERY [--alts ...]`	how well a description fits: cosine, z among the vocabulary, a verdict (strong / plausible / weak / no match) with held-out evidence
`rank QUERY PATHS...`	many candidate files sorted by a description (pick the best download)
`find FILE QUERY`	the best moments inside a long recording, as sample trims (start / end seconds)
`compare FILE --refs DIR` / `ab A B`	nearest reference recordings and typicality; A/B two sounds or two trims, the differences in words
`realness FILE...`	real recording / pro-produced vs code-synthesized, with evidence and per-window scores
`timeline FILE [--video V] [--cues C]`	the listening transcript: events (time, level, tag), sections, loudness, beat grid, sync of sound to picture cuts and cue frames
`sheet FILE -o out.png`	an annotated PNG (video frames, sections, labelled events, spectrogram, waveform, loudness, sync markers) for agents that read images
`critique FILE [--video V]`	a launch-video scorecard against a profile of 7 professional launch films, with timestamped fixes
`profile REFS... -o p.json`	build your own reference profile from films you admire
`measure FILE`	objective measurements only (no models): LUFS, true peak, LRA, envelope, spectrum, tempo / key
`forge RECIPE --refset CAT`	make a sound in code and improve it by listening (see below)
`fit FILE -o recipe.py`	translate a recording into a forge recipe module that re-renders it, with knobs and morphs (see below)
`sfx render ID -o x.wav`	a sound from the shipped bank of 252, aimed at the picture (`--dur`, `--apex`, `--pitch`) and audited; `sfx list`, `sfx check` (no models)
`kit init / render / check`	a film's sound kit: one bank sound per role, rendered into cached takes with measured onset / peak / end; the `launch` preset places each role against the music bed and the cut (no models)
`gallery DIR -o page.html`	one static HTML listening page of forge outputs: players, spectrograms, numbers
`llm FILE --yes-upload`	optional audio-LLM critique (Gemini), only with your own key and explicit consent
`mcp`	the same tools as an MCP server for Claude Code and other agents
`doctor [--load]`	check the install, models, data files and CPU settings

clips	earshot 0.3	earshot 0.4.0
dev (78): median CLAP, fits graded high	0.884, 19	0.921, 40
held-out (38): median CLAP, high	0.878, 7	0.909, 14 when opened (first-round engine); 0.903, 14 for 0.4.0 on the opened set
fresh held-out (28, harder: more music under the effects): median / mean CLAP	0.853 / 0.844	0.851 / 0.860
fresh held-out: mel gap to the clip, grades high / good / fair / poor	0.87 dB, 2 / 6 / 14 / 6	0.58 dB, 5 / 6 / 13 / 4
fresh held-out: takes that pass the take check, take CLAP	8, 0.809	7, 0.863

family	members	for
`ui_pop`	soft, step, boop, blip, fall, wide	rounded mid pops (0.12-0.2 s, 550-1030 Hz, 13-44 ms onsets): chips, bubbles, rows arriving
`knock`	wood, plastic, snap, desk, double	mid-band wood and plastic knocks (0.1-0.2 s)
`cut_hit`	sub, kick, punch, rumble, air	short sub hits with a kick, a punchy cut hit (0.2-0.5 s; rumble 1.4 s)
`mallet`	glock, celesta, marimba, pluck; flourish, up4	gated mallet notes (~0.35 s, glock and celesta wide), a soft pluck, chime runs; tuned by `--pitch`
`drip`	drop, bubble, plink, bloop, tiny	water drops whose pitch rises (the audit allows a bubble its climb)
`shutter`	dslr, snap, mirror, film, quick	camera shutters: a two-stage mechanical click for snap zooms and whip-cuts
`reverse_swell`	cymbal, ring, dark, short, breath	reverse cymbals and swells that peak just after a cut
new members	whoosh_big thump x3, riser dark / build / snatch, swish bright / flick, whoosh_fast whip, glitch burst / mid / chirp, notify mid_tine / mid_wood	a thump-whoosh, short dark risers without a synth sweep, bright swishes and a falling whip, glitches that hit first, rounded mid dings

Leonxlnx/earshot

earshot

What it does

Make sounds: earshot forge

earshot fit: audio to code

Sound for films: bank, sfx, kits

Gallery

Install

MCP server for Claude Code

Python

Agent skills

How good is it?

Limits

Repo map

Licence