VapourSynth R48 documentation

# 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. Simply run `vsrepo.py install <namespace or identifier>`. If you need a list of known scipts and plugins you can run `vsrepo.py available` or visit vsdb.top.

## 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:

1. <AppData>\VapourSynth\plugins32 or <AppData>\VapourSynth\plugins64

2. <VapourSynth path>\core32\plugins or <VapourSynth path>\core64\plugins

3. <VapourSynth path>\plugins32 or <VapourSynth path>\plugins64

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:

1. <VapourSynth.dll path>\vapoursynth32\coreplugins or <VapourSynth.dll path>\vapoursynth64\coreplugins

2. <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.