/butterflow

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

Primary LanguagePythonMIT LicenseMIT

About

Features

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

Demonstration

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 alone, but because it dupes frames and can't interpolate new ones, the video has a noticeable stutter (shown on the right-hand side).

See: Demonstrations for the script used to generate these files and for more demos including a 1080p example.

How to install

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.

Usage

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

More documentation

Check the docs folder.