Forrest logo
back to the ffplay tool


ffplay: Play a video and show motion vectors in real time.
$ ffplay -flags2 +export_mvs -vf codecview=mv=pf+bf+bb ${filename}
try on your machine

The command you provided is used to play video files using the ffplay media player, which is part of the FFmpeg multimedia framework.

Let's break down the components of the command:

  • ffplay: This is the actual command used to launch the ffplay media player.

  • -flags2 +export_mvs: This option enables the export of motion vectors (MVs). Motion vectors are used in video compression and represent the direction and magnitude of motion within a video frame. By including this flag, you can visualize and export motion vectors information for each frame.

  • -vf codecview=mv=pf+bf+bb: This option specifies a video filtergraph (indicated by -vf) to apply to the video stream. The filtergraph is composed of a video filter called codecview, which provides a variety of visualization tools for video analysis. In this case, the mv=pf+bf+bb argument within codecview enables the display of motion vectors for predicted frames (pf), bi-directional forward (bf), and bi-directional backward (bb) frames.

  • ${filename}: This is a placeholder variable that should be replaced with the actual filename or path of the video file you want to play using ffplay. Make sure to provide the appropriate path or filename to play the desired video.

Overall, the command enables the display and export of motion vectors using the ffplay media player, along with the specified visualization options provided by the codecview video filter.

This explanation was created by an AI. In most cases those are correct. But please always be careful and never run a command you are not sure if it is safe.
back to the ffplay tool