VapourSynth 101‎ > ‎

Software Setup

The guides below are designed to help users install the listed software.  If you are a Windows user, make sure your Operating System is 64-bit before continuing by checking to see if the folder "Program Files (x86)" exists.  If it does not then your operating system is 32-bit and you will need to use the directory "Program Files" for the tutorials instead.  Additionally you will need to use "System32" instead of "SysWOW64" when setting up system dependencies.

NOTE: If you are a macOS user and wish to simplify the installation process then try out AMVpack, an all-in-one installer package including these tools and a few more!

I. Linux
  1. Dependancies
  2. VapourSynth
  3. VapourSynth-Editor
II. macOS
  1. Dependancies
  2. VapourSynth
  3. VapourSynth-Editor
III. Windows
  1. Python
  2. VapourSynth
  3. VapourSynth-Editor
  4. DGMPGDec (Optional)
IV. Install Plugins
  1. Linux & macOS
  2. Windows

I. Linux
IMPORTANT INFO FOR FEDORA USERS: When running ./configure for ffmpeg, l-smash, vapoursynth, x264, x265, and zimg, use --prefix=/usr
  1. Dependancies
    1. Create a folder to run the installs from:
      mkdir $HOME/.installs
    2. Create folder links to redirect files from the installer default to a location the OS uses:
      Fedora:
      Create a link for the plugins install directory to the VapourSynth one:
      sudo ln -s /usr/lib64/vapoursynth /usr/local/lib/vapoursynth
      Ubuntu:
      Check to see if the "site-packages" directory exists:
      if test -d /usr/local/lib/python3.4/site-packages; then echo "exists"; else echo "doesn't exist"; fi
      If it does, moving all the files to dist-packages and deleting the directory is recommended.
      Create a link to the "dist-packages" directory:
      sudo ln -s /usr/local/lib/python3.4/dist-packages /usr/local/lib/python3.4/site-packages
    3. Install some of the needed dependencies for VapourSynth and VapourSynth plugins:
      Fedora:
      sudo dnf install automake gcc gcc-c++ yasm libass-devel python3-devel libtool ImageMagick-c++-devel qt-devel fftw-devel redhat-rpm-config qt5-qtbase-devel
      sudo pip3 install cython
      Ubuntu
      sudo apt-get install build-essential git yasm libass-dev python3-pip python3-dev cython3 autoconf libtool libmagick++-dev qt5-default libfftw3-dev
    4. Download the remaining dependencies:
      git clone https://github.com/l-smash/l-smash.git
      git clone git://git.videolan.org/x264.git
      git clone https://github.com/ffmpeg/ffmpeg.git
      git clone https://github.com/sekrit-twc/zimg.git
    5. Install the dependency L-SMASH:
      cd $HOME/.installs/l-smash
      ./configure --enable-shared
      make lib
      sudo make install-lib
    6. Install the dependency x264:
      cd $HOME/.installs/x264
      ./configure --enable-shared
      make
      sudo make install
    7. Install the dependency FFMPEG:
      cd $HOME/.installs/ffmpeg
      ./configure --enable-gpl --enable-libx264 --enable-avresample --enable-shared
      make
      sudo make install
    8. Install the dependency zimg:
      cd $HOME/.installs/zimg
      ./autogen.sh
      ./configure
      make
      sudo make install

  2. VapourSynth
    1. Browse to the installs folder:
      cd $HOME/.installs
    2. Download VapourSynth:
      git clone https://github.com/vapoursynth/vapoursynth.git
    3. Browse to the new folder:
      cd $HOME/.installs/vapoursynth
    4. Run the following commands to install VapourSynth:
      ./autogen.sh
      ./configure
      make
      make install
    5. Create the directory for the vapoursynth.conf file:
      mkdir $HOME/.config/vapoursynth
    6. Use the vi editor to create and open the vapoursynth.conf file:
      echo 'UserPluginDir=/usr/local/lib' | sudo tee --append $HOME/.config/vapoursynth/vapoursynth.conf
    7. Now write to the library cache file and refresh it:
      echo 'include /usr/local/lib' | sudo tee --append /etc/ld.so.conf
      sudo ldconfig

  3. VapourSynth-Editor
    1. Browse to the installs folder:
      cd $HOME/.installs
    2. Download VapourSynth-Editor:
      git clone https://bitbucket.org/mystery_keeper/vapoursynth-editor.git
    3. Browse to the new folder:
      cd $HOME/.installs/vapoursynth-editor/pro
    4. Run the following commands to install VapourSynth-Editor:
      qmake pro.pro
      NOTE: Fedora uses qmake-qt5.
      make
    5. Create directory to store it in, move it there, and link vseditor to bin:
      mkdir $HOME/.Applications
      sudo mv ../build/release-64bit-gcc $HOME/.Applications/VapourSynth-Editor
      sudo ln -s $HOME/.Applications/VapourSynth-Editor/vsedit /usr/bin/vsedit
    6. (Optional for Ubuntu) Add VapourSynth-Editor to Unity search:
      sudo ln -s $HOME/.Applications/VapourSynth-Editor/vsedit.ico /usr/share/icons/vsedit.ico
      sudo gedit $HOME/.local/share/applications/vsedit.desktop


      Enter the following, save, then close gedit:
      [Desktop Entry]
      Type=Application
      Name=VapourSynth-Editor
      Comment=
      Icon=/usr/share/icons/vsedit.ico
      Exec=/usr/bin/vsedit
      Terminal=false
      Categories=VapourSynth;


II. macOS
  1. Dependancies
    1. Install Homebrew by running the following command:
      /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    2. A box should pop up to install Xcode, click Install and once it is finished click Done.
    3. Back in terminal press "return" and then enter your password to finish installing Homebrew.
    4. Bulk install more dependencies using Homebrew by running the follow command in terminal:
      brew install python3 yasm libass automake libtool zimg l-smash ffmpeg fftw
    5. Install the last dependency by running the follow command in terminal:
      pip3 install cython

  2. VapourSynth
    1. Create a folder to run the installs from:
      mkdir $HOME/.installs
    2. Browse to the new folder:
      cd $HOME/.installs
    3. Download VapourSynth:
      git clone https://github.com/vapoursynth/vapoursynth.git
    4. Browse to the new folder:
      cd $HOME/.installs/vapoursynth
    5. Run the following commands to install VapourSynth:
      ./autogen.sh
      ./configure
      make
      make install
    6. Create the directory for the vapoursynth.conf file:
      mkdir "$HOME/Library/Application Support/VapourSynth/"
    7. Use the vi editor to create and open the vapoursynth.conf file:
      vi "$HOME/Library/Application Support/VapourSynth/vapoursynth.conf"
    8. Press "i" on the keyboard and type the following:
      UserPluginDir=/usr/local/lib/
    9. Press "esc" and the press "Shift" + ":"
    10. Once ":" shows up at the bottom left of the terminal window type "wq" and then press "return".

  3. VapourSynth-Editor
    1. Download VapourSynth-Editor
    2. Open VapourSynthEditor.dmg and drag "VapourSynth Editor" into the Applications folder shortcut.


III. Windows
  1. Python
    1. Download Python 3.5.
      NOTE: The 64-bit version is recommend.
    2. Run python-3.5.1-amd64.exe
      NOTE: The file name will vary based on the version you download.
    3. On the Install Python Screen click "Install Now".
    4. On the Setup was successful Screen click Close.

  2. VapourSynth
    1. Download VapourSynth.
    2. Run vapoursynth-r31.exe
      NOTE: The file name will vary based on the version you download.
    3. On the Select Destination Location Screen click Next.
    4. On the Select Components Screen click Next.
    5. On the Select Menu Folder Screen click Next.
    6. On the Select Additional Tasks Screen click Next.
    7. On the Ready to Install Screen click Install.
      NOTE: If a box pops up asking to install Visual C++ 2013 & 2015 Update 1 click Yes.
    8. On the Completing the VapourSynth Setup Wizard Screen click Finish.

  3. VapourSynth-Editor
    1. Download the 64-bit (x64) version of VapourSynth-Editor.
      NOTE: Only download the 32-bit version if you installed the 32-bit version of Python & VapourSynth!
    2. Extract VapourSynthEditor-64bit.7z to the directory: C:\Program Files\VapourSynth-Editor
      NOTE: The file name will vary based on the version you download.
    3. Create a shortcut of vsedit-64bit.exe and place it in the location of your choice.

  4. DGMPGDec (Optional)
    1. Download DGMPGDec.
    2. Extract dgmpgdec158.zip to the directory: C:\Program Files (x86)\dgmpgdec
    3. Create a shortcut of DGIndex.exe and place it in the location of your choice.


IV. Installing Plugins

(COMING SOON)