Skip to content

Editing guide

Effects and color

Adjust the brightness, contrast and saturation of a clip, and animate text with presets.

Last updated:

You will learn#

  • how to correct the colour of a clip;
  • how to give text an entrance and an exit with a preset;
  • how to apply a colour filter and a blur to a clip;
  • what the product does not do.

The idea#

Colour correction is three numbers on a clip: brightness (-1 to 1, default 0), contrast (0 to 2, default 1) and saturation (0 to 2, default 1). A value equal to the default clears the stored one, so a clip that is back at the defaults has no correction at all. Both the preview and the export apply the correction through the same render plan.

For text, captions, clips and shapes there are six animation presets: fade_up, fade_down, pop, zoom_in, slide_left and slide_right. A preset writes keyframes (or, for the slides, a transition) on the in or the out edge, 0.4 seconds long unless you give a duration. The inspector has an Animation section with the preset and the edge.

Text styling (font, weight, size, colour, stroke, shadow and background) is described in Text and captions. Fades and slides between items are in Transitions.

Filters and blur#

clip.set_filter sets one filter of a fixed list, grayscale, sepia, invert, warm or cool (none is the default), and amount, from 0 (the original) to 1 (the full filter). clip.set_blur sets a Gaussian blur radius in pixels at the project resolution, from 0 to 100. Both are constant over the clip: they cannot be keyframed. A filter set to none with amount 1, or a blur of 0, clears the stored value. The filter is applied after the colour correction and before the blur, in the preview and in the export alike.

Terminal
vukem-video edit --project prj_7k2m9x4q1b clip.set_filter item_id=itm_m1n2p3q4r5   filter=sepia amount:=0.6
vukem-video edit --project prj_7k2m9x4q1b clip.set_blur item_id=itm_m1n2p3q4r5 radius:=12

An MCP agent sends the same operations through edit. The colour correction, the filter and the blur have no inspector section yet: use the command palette (Ctrl+K, Cmd+K on macOS), the CLI or an agent. There are no LUTs.

Quick start#

Terminal
vukem-video edit --project prj_7k2m9x4q1b clip.set_color item_id=itm_m1n2p3q4r5 \
  brightness:=0.1 saturation:=1.2
vukem-video edit --project prj_7k2m9x4q1b text.apply_preset item_id=itm_t1u2v3w4x5 \
  preset=fade_up edge=in

A preset replaces the keyframes of the same properties inside its edge and keeps the rest of the animation.

Common mistakes#

  • Setting a contrast above 2 or a brightness outside -1 to 1: E_VALIDATION.
  • Applying a preset, a filter or a blur to an audio item: E_TYPE_MISMATCH.
  • A blur radius above 100 or a filter amount outside 0 to 1: E_VALIDATION.
  • A preset duration longer than the item: the command is refused.

Next steps#