From SmoothVideo Project
Jump to: navigation, search


Homebrew recently dropped support for both 10.9 "Mavericks" and 10.10 "Yosemite" for some packages including mpv. See the workaround on the forums containing pre-built Vapoursynth and mpv.

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

Simple installation


  1. Mount SVP 4 Mac DMG image
  2. Move "SVP 4 Mac" icon into Applications
  3. 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!

Manual installation

  • 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"
  • 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.

  • 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

 xcode-select --install

and in the window opened press Install button.

mpv configuration

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:


VLC configuration

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

Available encoders

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