Stabilize

Tool for stabilize movements in sequence of images. It uses vid.stab library for stabilizing. It is experimental, results with vid.stab backend are not perfect for timelapse videos, but it depens on conditions. Just try it :-)

It needs fork of official vid.stab library that contains some fixes (for RGB colorspace), that are not merged to upstream yet. You can see pull requests for more details.

For documentation of tool arguments, see vid.stab README.

Usage: timelapse_stabilize [options] source(s)
Tool for stabilize movements in sequence of images.

Options:
  -h, --help                           Displays this help.
  -v, --version                        Displays version information.
  -o, --output <directory>             Output directory.
  -d, --dryrun                         Just parse arguments, check inputs and
                                       prints information.
  -V, --verbose                        Verbose output.
  --stab-md-threads <threads>          Number of threads used for motion
                                       detection. Default is count of physical
                                       processors -1.
  --stab-md-shakiness <shakiness>      Set the shakiness of input video or
                                       quickness of camera. It accepts an
                                       integer in the range 1-10, a value of 1
                                       means little shakiness, a value of 10
                                       means strong shakiness. Default value is
                                       5.
  --stab-md-accuracy <accuracy>        Set the accuracy of the detection
                                       process. It must be a value in the range
                                       1-15. A value of 1 means low accuracy, a
                                       value of 15 means high accuracy. Default
                                       value is 15.
  --stab-md-stepsize <stepsize>        Set stepsize of the search process. The
                                       region around minimum is scanned with 1
                                       pixel resolution. Default value is 6.
  --stab-md-mincontrast <mincontrast>  Set minimum contrast. Any measurement
                                       field having contrast below this value is
                                       discarded. Must be a floating point value
                                       in the range 0-1. Default value is 0.3.
  --stab-tripod <tripod>               Set reference frame number for tripod
                                       mode. If enabled, the motion of the
                                       frames is compared to a reference frame
                                       in the filtered stream, identified by the
                                       specified number. The intention is to
                                       compensate all movements in a
                                       more-or-less static scene and keep the
                                       camera view absolutely still. If set to
                                       0, it is disabled. The frames are counted
                                       starting from 1. 
  --stab-md-show <show>                Show fields and transforms in the
                                       resulting frames for visual analysis. It
                                       accepts an integer in the range 0-2.
                                       Default value is 0, which disables any
                                       visualization.
  --stab-tr-smoothing <smoothing>      Set the number of frames (value*2 + 1),
                                       used for lowpass filtering the camera
                                       movements. Default value is 10. For
                                       example, a number of 10 means that 21
                                       frames are used (10 in the past and 10 in
                                       the future) to smoothen the motion in the
                                       video. A larger value leads to a smoother
                                       video, but limits the acceleration of the
                                       camera (pan/tilt movements). 0 is a
                                       special case where a static camera is
                                       simulated.
  --stab-tr-campathalgo <campathalgo>  Set the camera path optimization
                                       algorithm. Accepted values are: 
                                       gauss: Gaussian kernel low-pass filter on
                                       camera motion (default).
                                       avg: Averaging on transformations.
  --stab-tr-maxshift <maxshift>        Set maximal number of pixels to
                                       translate frames. Default value is -1,
                                       meaning: no limit.
  --stab-tr-maxangle <maxangle>        Set maximal angle in radians
                                       (degree*PI/180) to rotate frames. Default
                                       value is -1, meaning: no limit.
  --stab-tr-blackcrop                  Fill empty frame borders by black color.
                                       By default is keep image from previous
                                       frame.
  --stab-tr-invert                     Invert transforms.
  --stab-tr-relative                   Consider transforms as relative to
                                       previous frame. Default is absolute
  --stab-tr-zoom <zoom>                Set percentage to zoom. A positive value
                                       will result in a zoom-in effect, a
                                       negative value in a zoom-out effect.
                                       Default value is 0 (no zoom).
  --stab-tr-optzoom <optzoom>          Set optimal zooming to avoid
                                       blank-borders. Accepted values are:
                                       0: Disabled.
                                       1: Optimal static zoom value is
                                       determined (only very strong movements
                                       will lead to visible borders) (default).
                                       2: Optimal adaptive zoom value is
                                       determined (no borders will be visible),
                                       see zoomspeed.
                                       Note that the value given at zoom is
                                       added to the one calculated here.
  --stab-tr-zoomspeed <zoomspeed>      Set percent to zoom maximally each frame
                                       (enabled when optzoom is set to 2). Range
                                       is from 0 to 5, default value is 0.25.
  --stab-tr-interpol <interpol>        Specify type of interpolation. Available
                                       values are:
                                       no: No interpolation.
                                       linear: Linear only horizontal.
                                       bilinear: Linear in both directions
                                       (default).
                                       bicubic: Cubic in both directions (slow
                                       speed).

Arguments:
  source(s)                            Source images (images or directories
                                       with images).