DO NOT USE VAPOURSYNTH VER.41!
Upgrade to ver.42 immediately:
brew upgrade vapoursynth
Compatible video players
- mpv 0.17 or later with Vapoursynth support
- Plex Media Player - requires libmpv built with Vapoursynth support
- IINA - requires libmpv built with Vapoursynth support
- VLC 2.2 or later
- Mount SVP 4 Mac DMG image
- Move "SVP 4 Mac" icon into Applications
- Double-click on Install mpv.command script to install all the stuff listed below and write default mpv.conf.
Note: this won't work on 10.9 and 10.10 - see below!
- Take OS X 10.9 "Mavericks" or later, 10.11 "El Capitan" or later is highly recommended.
- Install Homebrew:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
- 10.11+: Install mpv and Vapoursynth:
brew install --with-vapoursynth --with-bundle mpv brew linkapps mpv
Note: this step is essential even if you don't want to use mpv at all.
- 10.9, 10.10: see that article.
- It's recommended to install Intel Power Gadget for the SVP to be able to show real CPU frequency in the Performance Monitor.
Error: Xcode alone is not sufficient
In some cases Homebrew may ask for the additional command line tools installation. Type
and in the window opened press Install button.
Just add --input-ipc-server=/tmp/mpvsocket to mpv args (or config file, usually located in ~/.config/mpv/mpv.conf) and SVP should find it.
# this's to create ~/.config/mpv directory for the first time mpv --version echo "input-ipc-server=/tmp/mpvsocket" >> ~/.config/mpv/mpv.conf
Alternatively you can "open" video file via SVP - it'll launch mpv with the correct argument, assuming that mpv is actually installed either in $PATH or in /usr/local/bin (you can also define the actual path in SVP's settings - see main.setup.player and main.setup.player_args values).
Note: only "copy-back" hardware video decoders are compatible with Vapoursynth filters, use --hwdec=auto-copy.
Recommended minimal mpv.conf:
input-ipc-server=/tmp/mpvsocket hwdec-codecs=all hwdec=auto-copy opengl-early-flush=no hr-seek-framedrop=no
SVP's plugin for VLC replaces the "deinterlace" filter.
Install SVP's plugin via SVP main menu -> Utilities -> SVP in VLC. Then you'll be able to quickly "install" and "uninstall" SVP's plugin.
You must turn on deinterlace in VLC via Video -> Deinterlace -> On to start using SVP's plugin. Alternatively you can turn it on permanently: Tools -> Preferences -> Video -> Deinterlacing = On
Note 1: Hardware decoding may not be compatible with the Vapoursynth filter! To be investigated...
Transcoding with SVPcode
SVPcode can only use encoders provided by the ffmpeg installed. With the default Homebrew installation only the H.264 / Software button will work in Simple mode.
If you want to encode in H.265 (HEVC) you can update ffmpeg with the following command:
brew reinstall ffmpeg --with-x265
Muxing .MKV files
If the output format after transcoding is Matroska (.MKV) then it's highly recommended to additionally install mkvmerge command line tool (which is part of the MKVToolNix package):
brew install mkvtoolnix