Skip to main content

Custom Video Filter

FFmpeg Builder: Custom Video Filter

Adds a single custom video filter to the FFmpeg Builder.
This element is intended for advanced use cases where you need to apply FFmpeg video filters that are not available through built-in flow elements.

Each instance of this element adds one filter to the filter chain.
To apply multiple filters, add multiple Custom Video Filter elements to your flow in the desired order.


Filter

The FFmpeg video filter expression to apply.

This value is passed directly to FFmpeg without modification, so it must be valid FFmpeg filter syntax.

Examples

  • scale=1920:1080
    Resizes the video to a fixed resolution of 1920×1080.

  • crop=1280:720
    Crops the video to a 1280×720 area from the top-left corner.

  • hqdn3d=1.5:1.5:6:6
    Applies high-quality spatial and temporal denoising to reduce visual noise.

  • eq=contrast=1.2:brightness=0.05
    Adjusts image contrast and slightly increases brightness.

  • hue=s=0
    Removes color saturation, converting the video to grayscale.

warning

⚠️ This element does not validate filter syntax.
Invalid filters will cause FFmpeg to fail during execution.


Hardware Filter

Enable this option if the filter should be executed on the GPU instead of the CPU.

When enabled, the filter is treated as a hardware-accelerated filter and applied within the active hardware context (for example, CUDA, QSV, or VAAPI).

Important notes:

  • The filter must be compatible with the selected GPU and hardware acceleration method.
  • FileFlows does not automatically adjust or translate filters based on the detected GPU.
  • Incorrect configuration may result in FFmpeg errors or failed executions.

Only enable this option if you are certain the filter is supported by the target hardware.


Outputs

  1. The filter was successfully added to the FFmpeg Builder model and will be applied during processing.