{"_id":"@aldel/reverbgen","_rev":"3-d0385969275186c1079d5160ed3de67a","name":"@aldel/reverbgen","dist-tags":{"latest":"2.0.2"},"versions":{"2.0.0":{"name":"@aldel/reverbgen","version":"2.0.0","keywords":["impulse-response","reverb","audio","sound","reverberation","echo"],"author":{"name":"Alan deLespinasse"},"license":"Apache-2.0","_id":"@aldel/reverbgen@2.0.0","maintainers":[{"name":"aldel","email":"aldel@alum.mit.edu"}],"homepage":"https://github.com/adelespinasse/reverbGen","bugs":{"url":"https://github.com/adelespinasse/reverbGen/issues"},"dist":{"shasum":"f6db25767e6a044ceebb75594e64f1429fee269c","tarball":"https://registry.npmjs.org/@aldel/reverbgen/-/reverbgen-2.0.0.tgz","fileCount":11,"integrity":"sha512-lzClRhIcfyKm4n/I9QrY+Yl4DVCcRXk0JWlOTGxVfNJu6h09DJE5imZB0bG21j43xlNZktse+vr6DNUlvod2cQ==","signatures":[{"sig":"MEUCIQC08BO/nQzknf3wGWAtJrusdEIaWjQWMow8u8XAyyeejwIgei3XVq92HHkl5ogFKVGu8+VG4iwBXOqEZNMsYmM5Ge0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6532482},"main":"./dist/reverbgen.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/reverbgen.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/reverbgen.js","require":"./dist/reverbgen.cjs"}},"gitHead":"df56cd362f54a3da76157b8194e9d9b2c36855d6","scripts":{"dev":"vite","build":"npm run build:lib && npm run build:demo","preview":"vite preview","build:lib":"vite build --config vite.lib.config.ts","typecheck":"tsc --noEmit","build:demo":"vite build"},"_npmUser":{"name":"aldel","email":"aldel@alum.mit.edu"},"repository":{"url":"git+https://github.com/adelespinasse/reverbGen.git","type":"git"},"_npmVersion":"10.9.2","description":"A TypeScript library for generating artificial reverb impulse responses.","directories":{},"_nodeVersion":"22.14.0","_hasShrinkwrap":false,"devDependencies":{"vite":"^5.0.0","typescript":"^5.0.0","@types/node":"^25.3.5","vite-plugin-dts":"^3.0.0"},"_npmOperationalInternal":{"tmp":"tmp/reverbgen_2.0.0_1773593438720_0.4659219914859085","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"name":"@aldel/reverbgen","version":"2.0.1","keywords":["impulse-response","reverb","audio","sound","reverberation","echo"],"author":{"name":"Alan deLespinasse"},"license":"Apache-2.0","_id":"@aldel/reverbgen@2.0.1","maintainers":[{"name":"aldel","email":"aldel@alum.mit.edu"}],"homepage":"https://github.com/adelespinasse/reverbGen","bugs":{"url":"https://github.com/adelespinasse/reverbGen/issues"},"dist":{"shasum":"280fffbd6f8f2053b958468ef82e265c0e0a9a6a","tarball":"https://registry.npmjs.org/@aldel/reverbgen/-/reverbgen-2.0.1.tgz","fileCount":11,"integrity":"sha512-ZXrW2+D8tdBSrratOPjo9ld8eHGWRWW+3PYO1yY6FGDvfa1ztmzp3/hlJgNZj/yQptFsK1le4MZW7TjW8CiqgA==","signatures":[{"sig":"MEUCIQCH2i6Z7r6GZ0Nsazcv3iogM6hFM9rOz95T/+WP0hhSEgIgdmTZ1uSGIs8xhnOD0iEoFq10DObWTKC6QUhKgPKKnsk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6532502},"main":"./dist/reverbgen.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/reverbgen.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/reverbgen.js","require":"./dist/reverbgen.cjs"}},"gitHead":"43a4d2f0db2676c878a5de720fac9d399be09669","scripts":{"dev":"vite","build":"npm run build:lib && npm run build:demo","preview":"vite preview","build:lib":"vite build --config vite.lib.config.ts","typecheck":"tsc --noEmit","build:demo":"vite build"},"_npmUser":{"name":"aldel","email":"aldel@alum.mit.edu"},"repository":{"url":"git+https://github.com/adelespinasse/reverbGen.git","type":"git"},"_npmVersion":"10.9.2","description":"A TypeScript library for generating artificial reverb impulse responses.","directories":{},"_nodeVersion":"22.14.0","_hasShrinkwrap":false,"devDependencies":{"vite":"^5.0.0","typescript":"^5.0.0","@types/node":"^25.3.5","vite-plugin-dts":"^3.0.0"},"_npmOperationalInternal":{"tmp":"tmp/reverbgen_2.0.1_1773594279712_0.09571841452267749","host":"s3://npm-registry-packages-npm-production"}},"2.0.2":{"name":"@aldel/reverbgen","version":"2.0.2","description":"A TypeScript library for generating artificial reverb impulse responses.","type":"module","main":"./dist/reverbgen.cjs","module":"./dist/reverbgen.js","types":"./dist/index.d.ts","exports":{".":{"import":"./dist/reverbgen.js","require":"./dist/reverbgen.cjs","types":"./dist/index.d.ts"}},"scripts":{"dev":"vite","build:lib":"vite build --config vite.lib.config.ts","build:demo":"vite build","build":"npm run build:lib && npm run build:demo","preview":"vite preview","typecheck":"tsc --noEmit"},"repository":{"type":"git","url":"git+https://github.com/adelespinasse/reverbGen.git"},"keywords":["impulse-response","reverb","audio","sound","reverberation","echo"],"author":{"name":"Alan deLespinasse"},"license":"Apache-2.0","bugs":{"url":"https://github.com/adelespinasse/reverbGen/issues"},"homepage":"https://github.com/adelespinasse/reverbGen","devDependencies":{"@types/node":"^25.3.5","typescript":"^5.0.0","unplugin-dts":"^1.0.0","vite":"^8.0.13"},"_id":"@aldel/reverbgen@2.0.2","gitHead":"9af7b00407a014309f8d51d0facbb6d901ff3999","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-wB/q1yvfE2hR5gsUxMuzHdSo9yh4gBfK2UkSbZ1rB3jUqnd/Mp78+v1NoCmioeZdkih36EV/i+E88stZwETkpw==","shasum":"1e25e8ed2851f131d98033bc87442310e0776252","tarball":"https://registry.npmjs.org/@aldel/reverbgen/-/reverbgen-2.0.2.tgz","fileCount":11,"unpackedSize":6532318,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDIpRj8JZZs1GBEZygsEYmrb+/8JbfbJpWhEoalgmit1AiA7jRDK+e6K0Wn/tX++iFw7As2CBnfgyPq1wK6RgSEvDw=="}]},"_npmUser":{"name":"aldel","email":"aldel@alum.mit.edu"},"directories":{},"maintainers":[{"name":"aldel","email":"aldel@alum.mit.edu"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/reverbgen_2.0.2_1778945206916_0.8951794881817081"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-15T16:50:38.604Z","modified":"2026-05-16T15:26:47.377Z","2.0.0":"2026-03-15T16:50:39.017Z","2.0.1":"2026-03-15T17:04:40.124Z","2.0.2":"2026-05-16T15:26:47.266Z"},"bugs":{"url":"https://github.com/adelespinasse/reverbGen/issues"},"author":{"name":"Alan deLespinasse"},"license":"Apache-2.0","homepage":"https://github.com/adelespinasse/reverbGen","keywords":["impulse-response","reverb","audio","sound","reverberation","echo"],"repository":{"type":"git","url":"git+https://github.com/adelespinasse/reverbGen.git"},"description":"A TypeScript library for generating artificial reverb impulse responses.","maintainers":[{"name":"aldel","email":"aldel@alum.mit.edu"}],"readme":"# reverbGen\n\nA TypeScript library for generating artificial reverb impulse responses.\n\nThis library generates simulated room impulse responses that sound fairly decent when used in convolution reverb effects, including the Web Audio API's ConvolverNode. You can use it in your web apps to generate impulse responses as needed, or generate sound files in advance to use in any audio application.\n\nIf you just want to generate some impulse responses, see the hosted app at [aldel.com/reverbgen](https://aldel.com/reverbgen).\n\nThe method used to generate the impulse responses is somewhat inspired by the classic paper [About This Reverberation Business](https://www.researchgate.net/publication/239735102_About_This_Reverberation_Business), by James A. Moorer, which notes that exponentially decaying white noise makes a surprisingly good sounding reverb response. This implementation adds a short user-selectable fade-in time and a gradually changing lowpass filter.\n\n## Installation\n\n```\nnpm install @aldel/reverbgen\n```\n\n## Usage\n\n### generateReverb(params)\n\nGenerates a reverb impulse response as an `AudioBuffer`. Returns a `Promise<AudioBuffer>`.\n\n```typescript\nimport { generateReverb } from '@aldel/reverbgen';\n\nconst audioContext = new AudioContext();\nconst convolver = audioContext.createConvolver();\n\nconvolver.buffer = await generateReverb({\n  decayTime: 2.5,          // -60dB decay time in seconds (required)\n  sampleRate: audioContext.sampleRate,\n  numChannels: 2,          // default: 2\n  fadeInTime: 0.1,         // fade-in time in seconds, default: 0\n  lpFreqStart: 15000,      // starting lowpass frequency in Hz, default: 0 (no filter)\n  lpFreqEnd: 1000,         // lowpass frequency at the -60dB point in Hz, default: 0\n});\n```\n\nAll parameters except `decayTime` are optional.\n\n| Parameter | Type | Default | Description |\n|---|---|---|---|\n| `decayTime` | `number` | — | **Required.** The -60dB decay time in seconds. |\n| `sampleRate` | `number` | `48000` | Sample rate in Hz. Pass `audioContext.sampleRate` to match your playback context. |\n| `numChannels` | `number` | `2` | Number of audio channels. |\n| `fadeInTime` | `number` | `0` | Fade-in time in seconds. |\n| `lpFreqStart` | `number` | `0` | Starting frequency for a gradually-applied lowpass filter in Hz. `0` disables the filter. |\n| `lpFreqEnd` | `number` | `0` | Lowpass filter frequency at the -60dB point in Hz. |\n\n### generateGraph(data, width, height, min, max)\n\nCreates a `<canvas>` element showing a graph of the given data. Useful for visualizing the impulse response waveform.\n\n```typescript\nimport { generateGraph } from '@aldel/reverbgen';\n\nconst buffer = await generateReverb({ decayTime: 2.5 });\nconst canvas = generateGraph(buffer.getChannelData(0), 400, 150, -1, 1);\ndocument.body.appendChild(canvas);\n```\n\n### saveWavFile(buffer, name, minTail?)\n\nSaves an `AudioBuffer` as a normalized 16-bit WAV file, triggering a browser download.\n\n```typescript\nimport { saveWavFile } from '@aldel/reverbgen';\n\nconst buffer = await generateReverb({ decayTime: 2.5 });\nsaveWavFile(buffer, 'my-reverb.wav', 5);\n```\n\nThe optional `minTail` parameter truncates trailing near-silence: the file is cut at the last sample frame where any channel has an absolute value (post-normalization, as a 16-bit integer) greater than `minTail`. Defaults to `0` (no truncation).\n","readmeFilename":"README.md"}