Skip to content

Instantly share code, notes, and snippets.

@zenwalk

zenwalk/ffmpeg-watermark.md

Forked from bennylope/ffmpeg-watermark.md
Created April 28, 2023 18:58
Show Gist options
  • Save zenwalk/bedadd3bc01b00b82fb21cfa573c2987 to your computer and use it in GitHub Desktop.
Save zenwalk/bedadd3bc01b00b82fb21cfa573c2987 to your computer and use it in GitHub Desktop.
Download ZIP

Revisions

  1. Webkader created this gist Jul 13, 2015.
    34 changes: 34 additions & 0 deletions ffmpeg-watermark.md
    View file
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,34 @@
    ## How to Add a Watermark to Video

    [FFMPEG filters](https://www.ffmpeg.org/ffmpeg-filters.html) provide a powerful way to programmatically enhance or alter videos, and it’s fairly simple to add a watermark to a video using the overlay filter. The easiest way to install ffmpeg is to [download](https://www.ffmpeg.org/download.html) a pre-built binary for your specific platform. Then you don’t have to worry about including and installing all the right dependencies and codecs you will be using.

    Once you have ffmpeg installed, adding a watermark is as easy as passing your existing source through an overlay filter like so:

    <pre>ffmpeg -i test.mp4 -i watermark.png -filter_complex "overlay=10:10" test1.mp4</pre>

    Basically, we’re passing in the original video, and an overlay image as inputs, then passing it through the filter, and saving the output as test1.mp4.

    We specify a specific position of the overlay in pixels – **10:10** puts the video 10 pixels from the top and 10 pixels from the right. (x:y coordinates)

    In some cases you might not know the exact dimensions of the videos you’ll be watermarking. Fortunately, there are variables you can use to better position your watermark depending on the size of the video. These variables include:

    * **main_h** – the video’s height
    * **main_w** – the video’s width
    * **overlay_h** – the overlay’s height
    * **overlay_w** – the overlay’s width

    Using these variable we can position the watermark right in the center of the video like so:

    <pre>ffmpeg -i test.mp4 -i watermark.png \
    -filter_complex "overlay=x=(main_w-overlay_w)/2:y=(main_h-overlay_h)/2" test2.mp4</pre>

    If we wanted to add branding or a watermark to the clip but not cover the existing video, we can use the [pad filter](https://www.ffmpeg.org/ffmpeg-filters.html#pad) to add some padding to our clip, and then position our watermark over the padding like so:

    <pre>ffmpeg -i test.mp4 -i watermark2.png \
    -filter_complex "pad=height=ih+40:color=#71cbf4,overlay=(main_w-overlay_w)/2:main_h-overlay_h" \
    test3.mp4</pre>

    Once you start getting the hang of this, you can even animate your overlays!

    <pre>ffmpeg -i test.mp4 -i watermark.png \
    -filter_complex "overlay='if(gte(t,1), -w+(t-1)*200, NAN)':(main_h-overlay_h)/2" test4.mp4</pre>