Need help with Mesh-Flow-Video-Stabilization?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

189 Stars 42 Forks 15 Commits 16 Opened issues


Online video stabilization using a novel MeshFlow motion model

Services available


Need anything else?

Contributors list

No Data




The MeshFlow is a spatial smooth sparse motion field with motion vectors only at the mesh vertexes. The MeshFlow is produced by assigning each vertex an unique motion vector via two median filters. The path smoothing is conducted on the vertex profiles, which are motion vectors collected at the same vertex location in the MeshFlow over time. The profiles are smoothed adaptively by a novel smoothing technique, namely the Predicted Adaptive Path Smoothing (PAPS), which only uses motions from the past.

Getting Started

  • To stabilize a video execute the script

    • python 
      - To run experiments ipython-notebook is present in
      - The stable output video is saved to
      directory of cloned repository


  • Required Packages:

    • opencv:
      pip install --user opencv-python
    • numpy:
      pip install --user numpy
    • scipy:
      pip install --user scipy
    • tqdm:
      pip install --user tqdm
  • Optional Packages:

    • cvxpy:
      pip install --user cvxpy

Motion Propagation

Mesh Flow only operate on a sparse regular grid of vertex profiles, such that the expensive optical flow can be replaced with cheap feature matches. For one thing, they are similar because they both encode strong spatial smoothness. For another, they are different as one is dense and the other is sparse. Moreover, the motion estimation methods are totally different. Next, we show estimatation of spacial coherent motions at mesh vertexes.

Initial motion vectors


  • initial motion meshes are dumped into

Final motion vectors


  • final motion meshes are dumped into

Predicted Adaptive Path Smoothing (PAPS)

A vertex profile represents the motion of its neighboring image regions. MeshFlow can smooth all the vertex profiles for the smoothed motions. It begin by describing an offline filter, and then extend it for online smoothing.

Path smoothening


  • Green is the optimized result
  • Blue is the motion vector accumulation
  • vertex profile paths are dumped into


We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.