FFmpeg AdvancedInstall

Summary

Execute raw FFmpeg arguments on input media and return processed binary data or save to disk.

Inputs

• inputSource — Source of the input media file. 'binary' reads from the binary property; 'path' uses the inputFilePath field. Default: binary.
• inputPath — Absolute path to the input file. Shown and required when inputSource is 'path'.
• customArgs — Raw FFmpeg arguments separated by spaces. Do not include input/output file paths. Default: '-c:v libx264 -preset slow -crf 22'.
• outputExtension — File extension for the resulting output (e.g. mp4, mp3). Default: mp4.
• saveToFile — Whether to save the processed file to a specific path on disk instead of returning binary data. Default: false.
• filePath — Full absolute path where the file should be saved. Required when saveToFile is true.
• fileName — Optional custom filename without extension for binary data. If empty, a UUID is used. Shown when saveToFile is false.
• binaryPropertyName — Name of the binary property containing the media file to process. Default: 'data'. Shown when inputSource is 'binary'.

Output shape

Binary data or saved-file marker

When saveToFile is true: returns item with json { saved: true, outputFilePath: '' } and empty binary. When saveToFile is false: returns item with binary data placed under the key specified by binaryPropertyName (default 'data'), filename derived from fileName or generated UUID combined with outputExtension.

Examples

Example 1: Process a binary input with custom FFmpeg args and return result as binary.

inputSource=binary, customArgs='-c:v libx264 -preset slow -crf 22', saveToFile=false, outputExtension=mp4

Example 2: Save processed video to a specific disk path.

inputSource=path, inputPath='/tmp/input.mp4', saveToFile=true, filePath='/output/video.mp4', outputExtension=mp4