Skip to content

Instantly share code, notes, and snippets.

@max-mapper
Last active January 31, 2025 03:52
Show Gist options
  • Select an option

  • Save max-mapper/43219d6dcb9006042849 to your computer and use it in GitHub Desktop.

Select an option

Save max-mapper/43219d6dcb9006042849 to your computer and use it in GitHub Desktop.
Video stabilization using VidStab and FFMPEG (Mac OS X)

Video stabilization using VidStab and FFMPEG

Examples here use the default settings, see the VidStab readme on GitHub for more advanced instructions.

Here's an example video I made

Install ffmpeg with the vidstab plugin from homebrew

brew install ffmpeg --with-libvidstab

Analyze your video to create a .trf file

This won't modify your video or create a new video, but it should create a new file called transform.trf

ffmpeg -i clip.mov -vf vidstabdetect -f null -

Use the .trf file to create a stabilized video

ffmpeg -i clip.mov -vf vidstabtransform=smoothing=5:input="transforms.trf" clip-stabilized.mov

This should create a new stabilized video called clip-stabilized.mov

Bonus: create a side by side comparison video

Found on a forum here

ffmpeg -i Clip8.mov -i Clip8-vidstab.mov -filter_complex "[0:v:0]pad=iw*2:ih[bg]; [bg][1:v:0]overlay=w" merged.mov
@ArneAnka

Copy link
Copy Markdown

@ArneAnka Homebrew is removing options for installing customizing packages, including FFMPEG with libvidstab.

That was a bummer...

@pnbv

pnbv commented Feb 13, 2019

Copy link
Copy Markdown

@ArneAnka Regarding current state of macOS homebrew installation (with options), feel free to use the following:

brew remove ffmpeg

brew tap pnbv/homebrew-ffmpegvidstab

brew install pnbv/homebrew-ffmpegvidstab/ffmpeg

Check brew tap docs and manage your own custom formula (for vid.stab only you can just duplicate mine, above)

@kpennell

Copy link
Copy Markdown

@pnbv Thanks for making this.

https://docs.brew.sh/Taps

@kibotu

kibotu commented Aug 23, 2019

Copy link
Copy Markdown

https://github.com/varenc/homebrew-ffmpeg#installation-and-usage

brew tap varenc/ffmpeg
brew install varenc/ffmpeg/ffmpeg --with-libvidstab

@mkormendy

Copy link
Copy Markdown

@kibotu what is the difference between varenc's version over pnbv's?

@kibotu

kibotu commented Oct 8, 2019

Copy link
Copy Markdown

well not quite sure exactly, but that one worked for me and the other didn't :/ just wanted to drop this info in case someone else couldn't get the main example to work :3

@yefim

yefim commented Dec 10, 2019

Copy link
Copy Markdown

Looks like varenc/ffmpeg/ffmpeg has been superseded by homebrew-ffmpeg/ffmpeg according to https://github.com/varenc/homebrew-ffmpeg.

@silasfc

silasfc commented Dec 10, 2020

Copy link
Copy Markdown

What is -f null - do?

This (-f null -) occurs because when performing step 1 (vidstabdetect) we do not (yet) need the final video file, but only "transforms.trf", necessary for step 2 (vidstabtransform).

By the way: "-f" specifies the output format (null in this case) for ffmpeg.

@gth001

gth001 commented Oct 31, 2021

Copy link
Copy Markdown

Edits from 2021. There's some errors/inefficiencies above due to changes since it was written (in Dec 2015).

With ffmpeg -i clip.mkv -vf vidstabdetect -f null -I just get the error
No such filter: 'vidstabdetect'

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment