Skip to main content

​
Overview

Welcome to the FFmpeg integration guide for Julep! This integration allows you to process media files using FFmpeg commands, enabling you to build workflows that require advanced media processing capabilities. Whether you’re converting video formats or extracting audio, this guide will walk you through the setup and usage.

​
How to Use the Integration

To get started with the FFmpeg integration, follow these steps to configure and create a task:
1

Define Your FFmpeg Command

Use the following YAML configuration to define your FFmpeg command and process media files:
FFmpeg Example
name: FFmpeg Task

tools:
- name: ffmpeg_tool
  type: integration
  integration:
    provider: ffmpeg
    method: bash_cmd

main:
- tool: ffmpeg_tool
  arguments:
    cmd: $ "ffmpeg -i input.mp4 -vn -acodec copy output.aac"
    file: base64_encoded_file # this is a placeholder for the actual file
The base64_encoded_file is the base64 encoded file to process which in this case is the input.mp4 file. The file argument can accept either a single base64 encoded string or a list of base64 encoded strings. However, even when passing a list of files, the FFmpeg command can only use a single input file (single -i flag). Multiple input files with multiple -i flags are not supported.

​
YAML Explanation

  • name: A descriptive name for the task, in this case, “FFmpeg Task”.
  • tools: This section lists the tools or integrations being used. Here, ffmpeg_tool is defined as an integration tool.
  • type: Specifies the type of tool, which is integration in this context.
  • integration: Details the provider and setup for the integration.
    • provider: Indicates the service provider, which is ffmpeg for FFmpeg.
    • method: Indicates the method to be used, which is bash_cmd for FFmpeg. If not specified, the method will be bash_cmd by default.
  • main: Defines the main execution steps.
    • tool: Refers to the tool defined earlier (ffmpeg_tool).
    • arguments: Specifies the input parameters for the tool:
      • cmd: The FFmpeg command to execute.
      • file: The base64 encoded file to process. Can be a single base64 encoded string or a list of base64 encoded strings.
Ensure your input file is base64 encoded and the FFmpeg command is correctly formatted for your specific use case.

​
Conclusion

With the FFmpeg integration, you can efficiently process media files using powerful FFmpeg commands. This integration provides a robust solution for media processing, enhancing your workflow’s capabilities and user experience.
For more information, please refer to the FFmpeg documentation.