Real World Performance: lazy loading, optimizing media, faster analytics join us Wednesday

ContactSign Up
Community Plugin
View plugin on GitHub


This is a low level helper plugin for video transcoding with ffmpeg.

You generally shouldn’t need to use this. You’re most likely looking for gatsby-remark-videos if you want to automatically convert videos in your markdown, or gatsby-transformer-ffmpeg if you’re looking to use these videos elsewhere in your website

Works with Gatsby v3.


npm install --save gatsby-plugin-ffmpeg

ffmpeg with the correct codecs is also required.


With Homebrew 2.0.3/ffmpeg 4.1.1 ffmpeg options are no longer available on the default tap.


The following will install ffmpeg.

brew tap varenc/ffmpeg
brew install ffmpeg $(brew options ffmpeg --compact)


Running with the environment variable DEBUG_FFMPEG=true will print the ffmpeg arguments used.

info ffmpeg is being executed with args: -i ~/markdown-pages/video.mp4 -y -an -vcodec libx264 -b:v 100k -filter:v
scale=w=1206:h=480 -profile:v main -pix_fmt yuv420p -movflags faststart
© 2023 Gatsby, Inc.