@radzor/video-transcode — LLM & AI Component | Radzor Registry

@radzor/video-transcode

Transcode video files between formats using FFmpeg subprocess. Supports format conversion, resolution scaling, codec selection, thumbnail extraction, and progress reporting.

Mediav0.1.0typescriptpythonServervideotranscodeffmpegmediaconversionencodingby Radzor

Install

View source on GitHub →

$npx radzor@latest add video-transcode

⚠ Constraints: Requires FFmpeg and FFprobe binaries installed on the system. Server-only (uses child_process). Transcode jobs are in-memory; progress is lost on process restart. Large files may take significant time and disk space.

Inputs

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

ffmpegPathstring

Path to the ffmpeg binary.

default: ffmpeg

ffprobePathstring

Path to the ffprobe binary for metadata extraction.

default: ffprobe

outputDirstring

Outputs

Name	Type	Description
transcodeResult	TranscodeResult	Result of a transcode operation. .outputPathstring .durationnumber .formatstring .sizenumber .codecstring

transcodeResultTranscodeResult

Result of a transcode operation.

.outputPathstring

.durationnumber

.formatstring

.sizenumber

.codecstring

radzor.manifest.json

{
  "llm": {
    "constraints": "Requires FFmpeg and FFprobe binaries installed on the system. Server-only (uses child_process). Transcode jobs are in-memory; progress is lost on process restart. Large files may take significant time and disk space.",
    "usageExamples": "llm/examples.md",
    "integrationPrompt": "llm/integration.md"
  },
  "name": "@radzor/video-transcode",
  "tags": [
    "video",
    "transcode",
    "ffmpeg",
    "media",
    "conversion",
    "encoding"
  ],
  "events": [
    {
      "name": "onTranscodeComplete",
      "payload": {
        "duration": "number",
        "inputPath": "string",
        "outputPath": "string"
      },
      "description": "Fired when a transcode operation completes successfully."
    },
    {
      "name": "onTranscodeFailed",
      "payload": {
        "error": "string",
        "exitCode": "number",
        "inputPath": "string"
      },
      "description": "Fired when a transcode operation fails."
    },
    {
      "name": "onProgress",
      "payload": {
        "fps": "number",
        "speed": "string",
        "percent": "number",
        "inputPath": "string"
      },
      "description": "Fired periodically during transcoding with progress information."
    }
  ],
  "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 for metadata extraction."
    },
    {
      "name": "outputDir",
      "type": "string",
      "required": false,
      "description": "Default output directory for transcoded files."
    }
  ],
  "radzor": "1.0.0",
  "actions": [
    {
      "name": "transcode",
      "params": [
        {
          "name": "inputPath",
          "type": "string",
          "description": "Path to the input video file."
        },
        {
          "name": "outputPath",
          "type": "string",
          "description": "Path for the output file."
        },
        {
          "name": "options",
          "type": "TranscodeOptions",
          "required": false,
          "description": "Transcoding options (codec, resolution, bitrate, etc.)."
        }
      ],
      "returns": "Promise<TranscodeResult>",
      "description": "Transcode a video file with the specified options."
    },
    {
      "name": "getProgress",
      "params": [
        {
          "name": "jobId",
          "type": "string",
          "description": "ID of the transcode job."
        }
      ],
      "returns": "ProgressInfo | null",
      "description": "Get the current progress of a running transcode job."
    },
    {
      "name": "extractThumbnail",
      "params": [
        {
          "name": "inputPath",
          "type": "string",
          "description": "Path to the video file."
        },
        {
          "name": "outputPath",
          "type": "string",
          "description": "Path for the output thumbnail image."
        },
        {
          "name": "timestamp",
          "type": "number",
          "required": false,
          "description": "Time position in seconds for the thumbnail."
        }
      ],
      "returns": "Promise<string>",
      "description": "Extract a thumbnail image from a video file."
    },
    {
      "name": "getMetadata",
      "params": [
        {
          "name": "inputPath",
          "type": "string",
          "description": "Path to the video file."
        }
      ],
      "returns": "Promise<VideoMetadata>",
      "description": "Get metadata (duration, resolution, codec, etc.) from a video file."
    }
  ],
  "outputs": [
    {
      "name": "transcodeResult",
      "type": "TranscodeResult",
      "fields": [
        {
          "name": "outputPath",
          "type": "string",
          "description": "Path to the transcoded output file."
        },
        {
          "name": "duration",
          "type": "number",
          "description": "Duration of the output file in seconds."
        },
        {
          "name": "format",
          "type": "string",
          "description": "Container format of the output (e.g. mp4, webm)."
        },
        {
          "name": "size",
          "type": "number",
          "description": "File size in bytes."
        },
        {
          "name": "codec",
          "type": "string",
          "description": "Video codec used (e.g. h264, vp9)."
        }
      ],
      "description": "Result of a transcode operation."
    }
  ],
  "runtime": "server",
  "version": "0.1.0",
  "category": "media",
  "languages": [
    "typescript",
    "python"
  ],
  "description": "Transcode video files between formats using FFmpeg subprocess. Supports format conversion, resolution scaling, codec selection, thumbnail extraction, and progress reporting.",
  "dependencies": {
    "radzor": [],
    "packages": {}
  },
  "composability": {
    "connectsTo": [
      {
        "output": "transcodeResult",
        "mapField": "outputPath",
        "compatibleWith": [
          "@radzor/s3-upload.action.upload.key",
          "@radzor/file-upload.action.upload.data"
        ]
      },
      {
        "event": "onTranscodeComplete",
        "description": "Upload transcoded video to storage",
        "compatibleWith": [
          "@radzor/s3-upload.action.upload.key",
          "@radzor/notification-hub.action.send.body"
        ]
      },
      {
        "event": "onTranscodeFailed",
        "description": "Alert on transcode failure",
        "compatibleWith": [
          "@radzor/error-tracker.action.captureMessage.message",
          "@radzor/slack-bot.action.sendMessage.text"
        ]
      }
    ]
  }
}

@radzor/video-transcode

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json