@audio/dynamics-ducker 0.1.0

package/ducker.js

@@ -0,0 +1,34 @@
+import { envelope } from '@audio/dynamics-envelope'
+import { compressorGain } from '@audio/dynamics-compressor'
+import { writer2, concat, db2lin, lin2db } from '@audio/dynamics-core'
+
+// External-sidechain compressor: main signal's gain is reduced in proportion
+// to the level of a separate side signal (e.g. voice track ducking music).
+export default function ducker(main, side, opts) {
+  if (!(main instanceof Float32Array)) return writer2(duckerStream(main))
+  let s = duckerStream(opts)
+  return concat(s.write(main, side), s.flush())
+}
+
+export function duckerStream(opts = {}) {
+  let threshold = opts.threshold ?? -30
+  let ratio = opts.ratio ?? 4
+  let knee = opts.knee ?? 6
+  let range = opts.range ?? -24  // max reduction in dB
+  let env = envelope({ ...opts, attack: opts.attack ?? 20, release: opts.release ?? 300 })
+
+  return {
+    write(main, side) {
+      let n = Math.min(main.length, side.length)
+      let out = new Float32Array(main.length)
+      for (let i = 0; i < n; i++) {
+        let rDb = compressorGain(lin2db(env(side[i])), threshold, ratio, knee)
+        if (rDb < range) rDb = range
+        out[i] = main[i] * db2lin(rDb)
+      }
+      for (let i = n; i < main.length; i++) out[i] = main[i]
+      return out
+    },
+    flush() { return new Float32Array(0) }
+  }
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@audio/dynamics-ducker",
+  "version": "0.1.0",
+  "description": "External-sidechain compressor: main signal's gain is reduced in proportion",
+  "type": "module",
+  "sideEffects": false,
+  "main": "ducker.js",
+  "exports": {
+    ".": "./ducker.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "ducker.js"
+  ],
+  "dependencies": {
+    "@audio/dynamics-core": "^0.1.0",
+    "@audio/dynamics-envelope": "^0.1.0",
+    "@audio/dynamics-compressor": "^0.1.0"
+  },
+  "keywords": [
+    "audio",
+    "dsp",
+    "dynamics",
+    "ducker"
+  ],
+  "license": "MIT",
+  "author": "Dmitry Iv. <dfcreative@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/audiojs/dynamics.git",
+    "directory": "packages/dynamics-ducker"
+  },
+  "homepage": "https://github.com/audiojs/dynamics/tree/main/packages/dynamics-ducker",
+  "bugs": {
+    "url": "https://github.com/audiojs/dynamics/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}