mike-hearn / butterflow

Make motion interpolated and fluid slow motion videos from the command line.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool


BF is a video manipulation tool that can:

  1. Make motion interpolated videos (increase a video's frame rate by rendering intermediate frames based on motion using a combination of pixel-warping and blending).
  2. Make smooth motion videos (do simple blending between frames).
  3. Leverage interpolated frames to make fluid slow motion videos.

BF works by rendering intermediate frames between existing frames using a process called motion interpolation. Given two existing frames, A and B, this program can generate frames C.1, C.2...C.n positioned between the two. In contrast to other tools that can only blend or dupe frames, this program warps pixels based on motion to generate new ones.

The addition of interpolated frames gives the perception of more fluid animation commonly found in high frame rate videos, an effect most people know as the "soap opera effect".

Besides creating motion interpolated videos BF can leverage interpolated frames to make fluid slow motion videos:

In these examples BF slowed a 1sec video down by 10x. An additional 270 frames were interpolated from 30 original source frames giving the video a smooth feel during playback. The same video was slowed down using FFmpeg without any filters, but because it dupes frames and can't interpolate new ones, the video has a noticeable stutter (shown on the right-hand side).


Important: BF only works on 64-bit systems.

Setup (for Windows and Linux users)

Note: No setup is necessary on macOS. Read this if you run into a problem with OpenCL.

BF requires no setup to use but it's too slow out of the box to do any serious work. To take advantage of hardware accelerated methods that will make rendering significantly faster you must set up a functional OpenCL environment on your machine.

See: Setting up OpenCL for details on how to do this.


Run butterflow -h for a full list of options. See: Example Usage for typical commands.

More documentation

Check the docs folder.


Make motion interpolated and fluid slow motion videos from the command line.

License:MIT License


Language:Python 71.1%Language:C++ 17.4%Language:Shell 6.2%Language:C 5.3%