n8n-nodes-ffmpeg-audio
v0.4.1
Published
n8n community node for audio processing with FFMPEG: merge/concatenate audio files (with optional crossfade and automatic sample-rate matching) and convert audio format, bit rate, and sample rate. FFMPEG binaries are bundled — no system install required.
Maintainers
Readme
n8n-nodes-ffmpeg-audio
An n8n community node for audio processing with FFMPEG. Merge and convert audio files directly inside your workflows.
FFMPEG binaries are bundled with the node (via ffmpeg-static and ffprobe-static), so there is no need to install FFMPEG on the host or in your container.
Installation · Operations · Usage · Compatibility · Resources
Installation
Follow the community node installation guide in the n8n docs.
Via the n8n UI (recommended):
- Go to Settings → Community Nodes.
- Select Install.
- Enter
n8n-nodes-ffmpeg-audio. - Agree to the risks and select Install.
Via npm (self-hosted):
npm install n8n-nodes-ffmpeg-audioOperations
This node provides an Audio resource with the following operations:
Merge Audio Files
Concatenates multiple audio files (read from the binary property of each incoming item) into a single output file.
- Automatically detects sample-rate mismatches between inputs and resamples so tracks join cleanly.
- Optional crossfade transition between tracks with a configurable duration.
- Output formats: MP3, WAV, OGG, AAC.
- Configurable bit rate (Auto or 8–320 kbps) and output file name.
Convert Audio
Converts each input audio file to a different format, bit rate, and/or sample rate. Processes each item independently and returns one output item per input.
- Output formats: MP3, WAV, OGG, AAC, FLAC, M4A, WMA, OPUS.
- Bit rate: keep original or 64–320 kbps.
- Sample rate: keep original or 8000–96000 Hz.
Timeout
Both operations expose a Timeout (Seconds) option (default 300). Each FFMPEG/FFPROBE operation must finish within this window or the node fails with a clear error instead of hanging. Increase it for large files or long merges, or set it to 0 to wait indefinitely.
Usage
- Add the FFMPEG node to your workflow.
- Select the Audio resource and choose an operation.
- Set Binary Property to the name of the binary field holding your audio data (default
data). - Configure the output options and run.
Merge example: Use a Merge node (or multiple items) to feed several audio files into the node, set the operation to Merge Audio Files, enable Crossfade if desired, and the node returns a single merged file on the data binary property.
Binary path configuration (optional)
By default the node uses the bundled FFMPEG/FFPROBE binaries. To use your own binaries instead, set these environment variables on the n8n process:
| Variable | Description |
| --- | --- |
| FFMPEG_PATH | Absolute path to the ffmpeg binary. |
| FFPROBE_PATH | Absolute path to the ffprobe binary. |
If a specified or bundled binary is not found, the node falls back to ffmpeg/ffprobe on the system PATH.
Compatibility
- Requires n8n with community node support (
n8nNodesApiVersion1). - Bundled FFMPEG/FFPROBE binaries support Linux, macOS, and Windows (x64/arm64). Binaries ship inside the package as platform-specific dependencies — no postinstall download or outbound internet access is required, so the node works in pnpm-based n8n installs and locked-down environments.
