{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "leonxlnx-earshot--generate-sound-effect-in-code",
 "repo": "Leonxlnx/earshot",
 "repo_url": "https://github.com/Leonxlnx/earshot",
 "repo_slug": "leonxlnx-earshot",
 "title": "Generate a sound effect in code and listen to it",
 "page_title": "How to generate a sound effect in code and listen to it with Earshot",
 "summary": "Render a sound from a recipe, score it by ear and iterate until it matches the references.",
 "who": "A game or UI developer whose agent needs a custom key press, click or whoosh and has no sound file to start from.",
 "problem": "Sound effects usually come from a library, so an agent cannot tune one to the exact feel of the product.",
 "outcome": "A set of WAV variants with a report, a spectrogram comparison and an audition file to listen to in pairs.",
 "steps": [
  "Run `earshot forge --list` to see the available recipes and reference sets.",
  "Run `earshot forge keypress --refs path/to/real/keypresses/ --budget 144 --variants 4 --dir made/keypress` with your own reference folder.",
  "Open `made/keypress/report.md` and `made/keypress/audition.wav` to review the picks against the references."
 ],
 "agent_prompt": "Use the earshot repo at <repo path>. Run `earshot forge --list`, then run `earshot forge <recipe> --refs <folder> --dir <out>`. Report the chosen WAV files and the critic's notes from report.md. Verify that the output folder contains report.json and the WAV files before you use them.",
 "agents": [
  "any"
 ],
 "difficulty": "Advanced",
 "time": "1 hour",
 "basis": "readme",
 "caveat": "The reference recordings are licensed and not in the repo, so you must supply your own with --refs or a local registry, and the README says the model checks can be pleased without the sound getting better, so judge the results by ear and by the model-free measurements.",
 "category": "Content",
 "tags": [
  "Content"
 ],
 "lang": "python",
 "requirements": [
  "Python and a working earshot install (the install steps are not in the README excerpt provided)",
  "A CPU; earshot runs locally on CPU and needs no GPU",
  "Sound files to test (WAV, OGG or MP4 with audio)",
  "Optional: your own licensed reference recordings for forge (not included in the repo)"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": false,
 "score": 0.7,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/leonxlnx-earshot/generate-sound-effect-in-code/",
 "md": "https://dedupedai.com/use-cases/leonxlnx-earshot/generate-sound-effect-in-code/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/leonxlnx-earshot--generate-sound-effect-in-code.json",
 "api_version": "v1"
}