@radzor/audio-mix — LLM & AI Component | Radzor Registry

@radzor/audio-mix

Mix, trim, and concatenate audio tracks using FFmpeg subprocess. Supports volume adjustment, format conversion, and metadata extraction for server-side audio processing.

Mediav0.1.0typescriptpythonServeraudiomixingffmpegtrimconcatenatemediaby Radzor

Install

View source on GitHub →

$npx radzor@latest add audio-mix

⚠ Constraints: Requires FFmpeg and FFprobe installed on the system. Server-only (uses child_process). Operations are synchronous per job; queue externally for high throughput.

Inputs

Name	Type	Default	Description
ffmpegPath	string	ffmpeg	Path to the ffmpeg binary.
ffprobePath	string	ffprobe	Path to the ffprobe binary.
outputDir	string	—	Default output directory for processed audio files.

ffmpegPathstring

Path to the ffmpeg binary.

default: ffmpeg

ffprobePathstring

Path to the ffprobe binary.

default: ffprobe

outputDirstring

Default output directory for processed audio files.

Outputs

Name	Type	Description
mixResult	MixResult	Result of an audio processing operation. .outputPathstring .durationnumber .formatstring .sizenumber

mixResultMixResult

Result of an audio processing operation.

.outputPathstring

.durationnumber

.formatstring

.sizenumber

radzor.manifest.json

{
  "llm": {
    "constraints": "Requires FFmpeg and FFprobe installed on the system. Server-only (uses child_process). Operations are synchronous per job; queue externally for high throughput.",
    "usageExamples": "llm/examples.md",
    "integrationPrompt": "llm/integration.md"
  },
  "name": "@radzor/audio-mix",
  "tags": [
    "audio",
    "mixing",
    "ffmpeg",
    "trim",
    "concatenate",
    "media"
  ],
  "events": [
    {
      "name": "onMixComplete",
      "payload": {
        "duration": "number",
        "outputPath": "string",
        "trackCount": "number"
      },
      "description": "Fired when an audio processing operation completes."
    }
  ],
  "inputs": [
    {
      "name": "ffmpegPath",
      "type": "string",
      "default": "ffmpeg",
      "required": false,
      "description": "Path to the ffmpeg binary."
    },
    {
      "name": "ffprobePath",
      "type": "string",
      "default": "ffprobe",
      "required": false,
      "description": "Path to the ffprobe binary."
    },
    {
      "name": "outputDir",
      "type": "string",
      "required": false,
      "description": "Default output directory for processed audio files."
    }
  ],
  "radzor": "1.0.0",
  "actions": [
    {
      "name": "mix",
      "params": [
        {
          "name": "tracks",
          "type": "TrackInput[]",
          "description": "Array of audio tracks to mix together."
        },
        {
          "name": "outputPath",
          "type": "string",
          "description": "Path for the output mixed file."
        },
        {
          "name": "options",
          "type": "MixOptions",
          "required": false,
          "description": "Mixing options (output format, sample rate, etc.)."
        }
      ],
      "returns": "Promise<MixResult>",
      "description": "Mix multiple audio tracks into a single output file."
    },
    {
      "name": "trim",
      "params": [
        {
          "name": "inputPath",
          "type": "string",
          "description": "Path to the input audio file."
        },
        {
          "name": "outputPath",
          "type": "string",
          "description": "Path for the trimmed output file."
        },
        {
          "name": "startTime",
          "type": "number",
          "description": "Start time in seconds."
        },
        {
          "name": "endTime",
          "type": "number",
          "required": false,
          "description": "End time in seconds."
        }
      ],
      "returns": "Promise<MixResult>",
      "description": "Trim an audio file to a specific time range."
    },
    {
      "name": "concatenate",
      "params": [
        {
          "name": "inputPaths",
          "type": "string[]",
          "description": "Ordered list of audio file paths to concatenate."
        },
        {
          "name": "outputPath",
          "type": "string",
          "description": "Path for the concatenated output file."
        }
      ],
      "returns": "Promise<MixResult>",
      "description": "Concatenate multiple audio files sequentially."
    },
    {
      "name": "adjustVolume",
      "params": [
        {
          "name": "inputPath",
          "type": "string",
          "description": "Path to the input audio file."
        },
        {
          "name": "outputPath",
          "type": "string",
          "description": "Path for the output file."
        },
        {
          "name": "volume",
          "type": "number",
          "description": "Volume multiplier (1.0 = original, 0.5 = half, 2.0 = double)."
        }
      ],
      "returns": "Promise<MixResult>",
      "description": "Adjust the volume of an audio file."
    },
    {
      "name": "getMetadata",
      "params": [
        {
          "name": "inputPath",
          "type": "string",
          "description": "Path to the audio file."
        }
      ],
      "returns": "Promise<AudioMetadata>",
      "description": "Get metadata (duration, format, bitrate, etc.) from an audio file."
    }
  ],
  "outputs": [
    {
      "name": "mixResult",
      "type": "MixResult",
      "fields": [
        {
          "name": "outputPath",
          "type": "string",
          "description": "Path to the output audio file."
        },
        {
          "name": "duration",
          "type": "number",
          "description": "Duration of the output in seconds."
        },
        {
          "name": "format",
          "type": "string",
          "description": "Audio format (e.g. mp3, wav, aac)."
        },
        {
          "name": "size",
          "type": "number",
          "description": "File size in bytes."
        }
      ],
      "description": "Result of an audio processing operation."
    }
  ],
  "runtime": "server",
  "version": "0.1.0",
  "category": "media",
  "languages": [
    "typescript",
    "python"
  ],
  "description": "Mix, trim, and concatenate audio tracks using FFmpeg subprocess. Supports volume adjustment, format conversion, and metadata extraction for server-side audio processing.",
  "dependencies": {
    "radzor": [],
    "packages": {}
  },
  "composability": {
    "connectsTo": [
      {
        "output": "mixResult",
        "mapField": "outputPath",
        "compatibleWith": [
          "@radzor/s3-upload.action.upload.key",
          "@radzor/file-upload.action.upload.data"
        ]
      },
      {
        "event": "onMixComplete",
        "description": "Upload mixed audio to cloud storage",
        "compatibleWith": [
          "@radzor/s3-upload.action.upload.key"
        ]
      }
    ]
  }
}

@radzor/audio-mix

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json