Membrane FFmpeg Video Filter Plugin

This package contains elements providing video filters based on ffmpeg video filter feature.

Currently only the TextOverlay element is implemented, based on ffmpeg drawtext filter. This element enables adding text on top of given raw video frames.

PRs with the implementation of other video filters are welcome!

Installation

The package can be installed by adding membrane_ffmpeg_video_filter_plugin to your list of dependencies in mix.exs:

def deps do
  [
	{:membrane_ffmpeg_video_filter_plugin, "~> 0.13.1"}
  ]
end

The precompiled builds of the ffmpeg will be pulled and linked automatically. However, should there be any problems, consider installing it manually.

Manual instalation of dependencies

macOS

brew install ffmpeg

Ubuntu

sudo apt-get install ffmpeg

Arch / Manjaro

pacman -S ffmpeg

Usage

TextOverlay

Below example pipeline adds "John Doe" text over h264 video in a specified style.

defmodule VideoFilter.Pipeline do
  use Membrane.Pipeline

  alias Membrane.File.{Sink, Source}
  alias Membrane.H264.FFmpeg.{Parser, Decoder, Encoder}
  alias Membrane.FFmpeg.VideoFilter.TextOverlay

  @impl true
  def handle_init(_ctx, _opts) do
    structure =
      child(:file_src, %Source{location: "input.h264"})
      |> child(:parser, %Parser{framerate: {10, 1}})
      |> child(:decoder, Decoder)
      |> child(:text_filter, %TextOverlay{
          text: "John Doe",
          x: :center,
          fontsize: 25,
          fontcolor: "white",
          border?: true
        }
      )
      |> child(:encoder,  Encoder)
      |> child(:file_sink,  %Sink{location: "output.h264"})

    {[spec: structure], %{}}
  end
end

Frame from original video:

Output frame with filter applied:

Copyright and License

Copyright 2021, Software Mansion

Licensed under the Apache License, Version 2.0