n8n-nodes-audio-tools/README.md

Community audio processing nodes for n8n: concatWithGap & mergeTracks

# n8n‑audio‑tools

Two minimalist audio nodes powered by FFmpeg:

| Node                    | What it does                    | Key params                         |
| ----------------------- | ------------------------------- | ---------------------------------- |
| **audio.concatWithGap** | `file1` → _(silence)_ → `file2` | `gapDuration`, `fadeIn`, `fadeOut` |
| **audio.mergeTracks**   | `file1` + _(delayed)_ `file2`   | `offset`, `file2Gain`              |

## Installation

```bash
npm install n8n-nodes-audio-tools
```

Then add to your **.n8n/n8n.config.js**:

```js
module.exports = {
    nodes: [require("n8n-nodes-audio-tools")],
};
```

## Requirements

-   _FFmpeg_ must be available in PATH (or set the `FFMPEG_PATH` env var).

## Examples

```ts
// Concat 1.5 s silence between intro & outro
{
  "file1": "/tmp/intro.wav",
  "file2": "/tmp/outro.wav",
  "gapDuration": 1.5,
  "outputFormat": "mp3"
}

// Overlay commentary 3 s after music,  -7 dB
{
  "file1": "/tmp/music.mp3",
  "file2": "/tmp/commentary.mp3",
  "offset": 3,
  "file2GainDb": -7
}
```

## License

MIT