heydarshahi / mv-tractus

A simple tool to extract motion vectors from h264 encoded videos.

MV-Tractus

A simple tool to extract motion vectors from H264 encoded video sources.

NOTE: This was a side project and never intended to be open sourced which is basically the reason behind the inappropriate coding style and project structure. However, at the time of starting this project there weren't any easy to use open source implementations for motion-vector extraction. MV-tractus was the outcome of an experiment to build a tool to extract motion-vectors by building a wrapper around FFmpeg. This tool only supports motion-vector extraction. If you are intending to use it in any other context then I am afraid this is not the right tool that you are looking for. FFmpeg core libraries have not been altered.

Disclaimer: The authors don't claim anything regarding the performance of the tool.

If you use this tool, please cite.

Jishnu P, & Singh, Praneet. (2018, October 21). MV-Tractus: A simple tool to extract motion vectors from H264 encoded video sources (Version 2.0). Zenodo.

@software{jishnu_p_2018_4422613,
  author       = {Jishnu P and
                  Singh, Praneet},
  title        = {{MV-Tractus: A simple tool to extract motion 
                   vectors from H264 encoded video sources}},
  month        = oct,
  year         = 2018,
  publisher    = {Zenodo},
  version      = {2.0},
  doi          = {10.5281/zenodo.4422613},
  url          = {https://doi.org/10.5281/zenodo.4422613}
}

Installation and bootstrapping

1. git clone https://github.com/jishnujayakumar/MV-Tractus.git
2. cd MV-Tractus
3. ./install_ffmpeg.sh (You can also install FFmpeg using the link here)
4. sudo cp ffmpeg.conf /etc/ld.so.conf.d/ffmpeg.conf && sudo ldconfig
5. ./compile OR You can use the compile_command.txt to generate the binary file.
6. mkdir -p output/mv/
7. ./extract_mvs <video-file-path> <output-path>.
8. And there you go. The output will be saved in <output-path>. If this parameter is not specified, then the output is saved in './output/mv/'.

pip install mv-tractus (Coming Soon).

Tutorials

Installation, Setup and Usage (extract_mvs)

Usage (extract_mvs_with_frames)

Python Usage (extract_mvs_with_frames)

Coming Soon...

NOTE: Due to the lack of time, I am not able to maintain this project. I would like to request the users and contributors to help each other in all possible ways by joining Slack.