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.

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

Common issues