Skip to main content

Video Overlay Transformations

Add text, image, and video overlays to your videos using our transformation parameters.

Layer Types

Layers are added using the l_{type}:{options} parameter. Multiple layers can be chained with plus signs.

Text Overlays

Add text overlays to your video:
Text layer parameters:
  • Text content (first parameter after type)
  • l_font_{name}: Font family name
  • l_size_{pixels}: Font size (1-500, default: 24)
  • l_color_{hex}: Text color (default: 000000)
  • l_gravity_{position}: Position anchor (default: center)
  • l_x_{pixels}: X offset from gravity point
  • l_y_{pixels}: Y offset from gravity point
  • l_o_{opacity}: Opacity 0-100 (default: 100)

Image Overlays

Add image overlays like watermarks:
Image layer parameters:
  • l_key_{path}: Media path (use @@ instead of /)
  • l_gravity_{position}: Position anchor
  • l_x_{pixels}: X offset
  • l_y_{pixels}: Y offset
  • l_o_{opacity}: Opacity 0-100
  • l_scale_{factor}: Scale factor 0-10
  • l_width_{pixels}: Target width
  • l_height_{pixels}: Target height
  • l_ar_{ratio}: Target aspect ratio

Video Overlays

Add video overlays like intros, watermarks, or picture-in-picture:
Video layer parameters:
  • l_key_{path}: Media path (use @@ instead of /)
  • l_gravity_{position}: Position anchor
  • l_x_{pixels}: X offset
  • l_y_{pixels}: Y offset
  • l_o_{opacity}: Opacity 0-100
  • l_scale_{factor}: Scale factor 0-10
  • l_width_{pixels}: Target width
  • l_height_{pixels}: Target height
  • l_ar_{ratio}: Target aspect ratio

Position Reference

Available gravity positions:
  • center (default)
  • north, south, east, west
  • north_east, north_west, south_east, south_west

Examples

Video Picture-in-Picture

Video Intro with Watermark

Text Over Video

Multiple Layer Types