Skip to content
hn-88 edited this page Apr 8, 2026 · 2 revisions

Motivation

This tool helps to add accelerated codec support for the transformations carried out by OCVWarp - please see the OCVWarp wiki for more information.

Installation

This tool needs ffmpeg to be installed and available on your system PATH.

If you don't want to deal with python module dependencies, you can just download and run the relevant standalone executable from Releases.

Cross-platform python virtual environment

  1. Install python - https://www.python.org/downloads/

  2. Create a venv (once per project) python3 -m venv ~/venvs/gui_env (this path is just an example.)

  3. Activate it source ~/venvs/gui_env/bin/activate prompt changes to something like: (gui_env) %

  4. Install the required packages python -m pip install --upgrade pip python -m pip install numpy scipy pillow

So, when I want to run py-ffmpeg-warp, I could run the following manually -

source ~/venvs/gui_env/bin/activate cd /home/path/to/py/script python3 py-ffmpeg-warp.py

Windows-specific

On Windows, various python modules can be installed with

pip install modulename

where we sometimes have to do an internet search to find the exact modulename.

Eg. How to Fix "ModuleNotFoundError: No Module Named 'PIL'" in Python

pip install pillow

Linux with apt

On my Linux Mint machine, where I've installed python using the default deb package with apt,

ModuleNotFoundError: No module named 'imageio'
and when trying to install with pip,

× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
    python3-xyz, where xyz is the package you are trying to
    install.

sudo apt install python3-imageio # this worked.