Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

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 v4.


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.

From https://trac.ffmpeg.org/wiki/CompilationGuide/macOS

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


Electric UI

Work on gatsby-plugin-ffmpeg is funded by Electric UI. If you need to design an Arduino GUI, want visualisations for a complex robotics system or generally need a user interface for your hardware project, please take a look at the website.

© 2023 Gatsby, Inc.