CloudConvert icon

CloudConvert

Use CloudConvert to convert files, create thumbnails, merge files, add watermarks and more!
Join our community

Actions51

Overview

This node executes custom commands using CloudConvert's supported engines such as FFmpeg, ImageMagick, or GraphicsMagick. It allows users to run complex file processing commands on input files, enabling advanced media and file manipulations like video encoding, image processing, and more. This is useful for scenarios where predefined operations are insufficient and custom command-line arguments are needed to achieve specific processing goals.

Use Case Examples

  1. Transcoding a video file using FFmpeg with custom codec options.
  2. Applying advanced image transformations using ImageMagick commands.
  3. Running GraphicsMagick commands to batch process images with specific effects.

Properties

Name Meaning
Authentication Method of authenticating with CloudConvert API, either OAuth2 or API Key.
Binary Input Data Whether the input file to upload should be taken from a binary field.
Input File Contents The text content of the file to upload, used if binary input data is false.
Input File Name The input filename including extension, used if binary input data is false.
Binary Property Name of the binary property containing the data for the file to be processed, used if binary input data is true.
Engine The engine to use for executing the command, e.g., FFmpeg, ImageMagick, or GraphicsMagick.
Command Base command to execute, e.g., 'ffmpeg' or 'convert'.
Arguments Arguments to pass to the command, specifying input/output files and processing options.
Capture Console Output Whether to capture and return the console output of the command.
Additional Options JSON dictionary of additional options to add to the converting task, allowing advanced configuration.

Output

JSON

  • data - Result data from the executed command, including any output files or command output.
  • consoleOutput - Captured console output of the command if 'Capture Console Output' is enabled.

Dependencies

  • CloudConvert API

Troubleshooting

  • Ensure the input file is correctly provided either as binary data or as text content with a valid filename.
  • Verify that the command and arguments are correctly formatted according to the CloudConvert Execute Commands API documentation.
  • If using API Key authentication, ensure the key is valid and has sufficient permissions.
  • If capturing console output, be aware that large outputs might affect performance or cause timeouts.

Links

Discussion