Installation¶
Basic Program¶
The installation contains two main steps:
Install VapourSynth core library.
Install the Python wrapper of VapourSynth.
After you completed the second step, you can test it by opening a Python command line and type this:
from vapoursynth import core
print(core.version())
After pressing return at the final line, you should see the version printed along with a
few other lines describing the options used when instantiating the Core object.
In fact, these lines should be the same as the output result of vspipe --version
.
Windows Installation¶
Prerequisites¶
- First download and install the prerequisites:
Python 3.9.x or Python 3.8.x – 32 or 64 bit version depending on which version of VapourSynth you want to install
Note that VapourSynth and Python have to be matched so both are either installed for all users or for only for the current user.
Also note that per user installs will not install the required Visual Studio 2019 runtimes.
Installation¶
Simply run the VapourSynth installer. It should automatically detect and install everything, including the Python wrapper.
If the tests mentioned at the beginning fails, there may be a bug in the installer or there are old copies of vapoursynth.pyd and vapoursynth.dll lying around.
Windows Installation (Portable)¶
- First download and decompress the prerequisites:
Python 3.9.x or Python 3.8.x – 32 or 64 bit embeddable version
Simply decompress the portable VapourSynth archive into the Python dir and overwrite all existing files. Done.
You can also use the VapourSynth Editor by decompressing it into the same directory.
OS X Installation¶
- First download and install the prerequisites:
Xcode – Available from the AppStore
Homebrew – A package manager
Simply run these commands in a terminal and wait for them to complete:
brew install vapoursynth
Linux installation¶
Several distributions have VapourSynth packages. Note that those packages are usually OUT OF DATE.
Debian¶
The VapourSynth packages are provided by deb-multimedia repository. You need to add the repository first following the guide on the official website.
Fedora, CentOS and RHEL¶
For Fedora, the VapourSynth packages can be downloaded from official repository directly. For CentOS and RHEL, you should install EPEL (Extra Packages for Enterprise Linux) repository first.
Gentoo¶
There is an unofficial Portage tree with all VapourSynth related ebuilds. Check the Github link for more information and instructions.
Arch Linux¶
VapourSynth-related packages are provided by the Community repository.
Windows Compilation¶
Preparing the Build Environment on Windows¶
Default install paths are assumed in all projects and scripts, be prepared to adjust many things if you changed them
Required languages and applications:
Needs Visual Studio 2019
It also needs both 32bit and 64bit Python 3.8.x and 3.9.x (the msvc project assumes that you installed python for all users.)
InnoSetup is needed to create the installer (default installation path assumed)
7-zip is needed to compress the portable version (default installation path assumed)
Preparing the C++ Project¶
Clone VapourSynth
Clone VSRepo into the VapourSynth dir (
git clone https://github.com/vapoursynth/vsrepo
)Clone zimg into the VapourSynth dir (
git clone https://github.com/sekrit-twc/zimg --branch v3.0
)Clone avs+ into the VapourSynth dir (
git clone https://github.com/AviSynth/AviSynthPlus.git
)Clone libp2p into the VapourSynth dir (
git clone https://github.com/sekrit-twc/libp2p.git
)Compile 32 and 64 bit releases using the VapourSynth solution
Preparing the Python Project¶
Run
py -3.9 -m pip install -r python-requirements.txt
for 64bit.Run
py -3.9-32 -m pip install -r python-requirements.txt
for 32bit.Run
py -3.8 -m pip install -r python-requirements.txt
for 64bit.Run
py -3.8-32 -m pip install -r python-requirements.txt
for 32bit.Run
cython_build.bat
to compile the Python modulesRun
docs_build.bat
to compile the documentation
Distribution¶
All the above steps are necessary to create the installer
You also need 7z.exe and 7z.dll from the 32 bit version of 7-zip Both need to be placed in the “installer” dir. (if you only plan to make 64 bit builds then the 64 bit version is ok to use instead)
You’ll also have to grab the file pfm-192-vapoursynth-win.exe
which is only available from installations/portable releases.
Run make_portable.bat
and make_installers.bat
to package things.
Note
Note that the Avisynth side of AVFS won’t work properly in debug builds (memory allocation and exceptions across module boundaries trolololol)
Linux and OS X Compilation¶
- These are the requirements:
Autoconf, Automake, and Libtool, probably recent versions
pkg-config
GCC 4.8 or newer, or Clang
Python 3
Cython 0.28 or later installed in your Python 3 environment
Sphinx for the documentation (optional)
iconv, libass, and ffmpeg for the Subtext plugin (optional)
ImageMagick 7 for the Imwri plugin (optional)
Tesseract 3 for the OCR plugin (optional)
Note: any version of Python 3 will do. A specific version is only required when using the official Windows binaries.
Required packages (OS X)¶
- First download and install the prerequisites:
Xcode – Available from the AppStore
Homebrew – A package manager
Installation of the required packages is very easy. Simply run these commands in a terminal and wait for them to complete:
brew install python3 ffmpeg libass zimg imagemagick
pip3 install cython
If you’ve already installed all the required packages and instead want to update them, simply run:
brew update && brew upgrade
pip3 install --upgrade cython
Compilation¶
If you haven’t checked out the source code before, use git to do so:
git clone https://github.com/vapoursynth/vapoursynth.git
Or if you already have a copy of the source, update it with:
git pull
Enter the VapourSynth directory and run these commands to compile and install:
./autogen.sh
./configure
make
make install
Depending on your operating system’s configuration, VapourSynth may not
work out of the box with the default prefix of /usr/local. Two errors
may pop up when running vspipe --version
:
“vspipe: error while loading shared libraries: libvapoursynth-script.so.0: cannot open shared object file: No such file or directory”
This is caused by the non-standard location of libvapoursynth-script.so.0. Your dynamic loader is not configured to look in /usr/local/lib. One way to work around this error is to use the LD_LIBRARY_PATH environment variable:
$ LD_LIBRARY_PATH=/usr/local/lib vspipe --version
“Failed to initialize VapourSynth environment”
This is caused by the non-standard location of the Python module, vapoursynth.so. Your Python is not configured to look in /usr/local/lib/python3.x/site-packages. One way to work around this error is to use the PYTHONPATH environment variable:
$ PYTHONPATH=/usr/local/lib/python3.x/site-packages vspipe --version
Replace “x” with the correct number.
The documentation can be built using its own Makefile:
$ make -C doc/ html
The documentation can be installed using the standard program cp
.
Plugins and Scripts¶
If you’re looking for plugins and scripts then one of the most complete lists available can be found at vsdb.top.
Installing with VSRepo¶
On windows you can use the included vsrepo.py to install and upgrade plugins and scripts.
Simply run vsrepo.py install <namespace or identifier>
to install them.
If you need a list of known plugins and scripts you can run vsrepo.py available
or visit vsdb.top.
For more reference, visit vsrepo’s repository
Installing Manually¶
You can put your plugin (.dll
) and script (.py
) to where you think it is convenient.
For plugins, you can use std.LoadPlugin
function to load it. there is also a plugin autoloading mechanism to save your time, see blow.
For scripts, you should add a relative path to python39._pth
or python38._pth
, then you can import it in your script.
Plugin Autoloading¶
VapourSynth automatically loads all the native plugins located in certain folders. Autoloading works just like manual loading, with the exception that any errors encountered while loading a plugin are silently ignored.
Note
Avoid autoloading from folders that other applications might also use, such as /usr/lib or /usr/local/lib in a Linux system. Several users reported crashes when VapourSynth attempted to load some random libraries (*cough*wxgtk*cough*).
Windows¶
Windows has in total 3 different autoloading directories: user plugins, core plugins and global plugins. They are searched in that order. User plugins are always loaded first so that the current user can always decide which exact version of a plugin is used. Core plugins follow. Global plugins are placed last to prevent them from overriding any of the included plugins by accident.
The searched paths are:
<AppData>\VapourSynth\plugins32 or <AppData>\VapourSynth\plugins64
<VapourSynth path>\core\plugins
<VapourSynth path>\plugins
Note that the per user path is not created by default. On modern Windows versions the AppData directory is located in <user>\AppData\Roaming by default.
Shortcuts to the global autoload directory are located in the start menu.
Avisynth plugins are never autoloaded. Support for this may be added in the future.
User plugins should never be put into the core\plugins directory.
Windows Portable¶
The searched paths are:
<VapourSynth.dll path>\vapoursynth32\coreplugins or <VapourSynth.dll path>\vapoursynth64\coreplugins
<VapourSynth.dll path>\vapoursynth32\plugins or <VapourSynth.dll path>\vapoursynth64\plugins
User plugins should never be put into the coreplugins directory.
Linux¶
Autoloading can be configured using the file $XDG_CONFIG_HOME/vapoursynth/vapoursynth.conf, or $HOME/.config/vapoursynth/vapoursynth.conf if XDG_CONFIG_HOME is not defined.
Two configuration options may be used: UserPluginDir, empty by default,
and SystemPluginDir, whose default value is set at compile time to
$libdir/vapoursynth
, or to the location passed to the --with-plugindir
argument to configure
.
UserPluginDir is tried first, then SystemPluginDir.
Example vapoursynth.conf:
UserPluginDir=/home/asdf/vapoursynth/plugins
SystemPluginDir=/special/non/default/location
OS X¶
Autoloading can be configured using the file $HOME/Library/Application Support/VapourSynth/vapoursynth.conf. Everything else is the same as in Linux.