SVP:Mac

Automatic installation uses Homebrew and works on macOS 12 Monterey or later!

For macOS 11 Big Sur and earlier see MacPorts method below.

Compatible video players

• mpv with Vapoursynth support
• Plex Media Player - requires libmpv built with Vapoursynth support
• IINA - requires libmpv built with Vapoursynth support
• VLC 3.0 or later

Installation

1. Mount SVP 4 Mac DMG image
2. Move "SVP 4 Mac" icon into Applications
3. Run SVP, it will ask to run an installation script if needed.
4. Alternatively, you can run the script later: SVP menu -> Utilities -> Reinstall mpv in Homebrew

Updating

Updating SVP app:

1. Download an updated DMG package
2. Mount it and replace SVP 4 Mac.app in Applications
3. That's it! You DON'T need to run Install mpv.command when updating SVP!

Updating mpv to the newer version: open Terminal and type

brew upgrade mpv

Uninstall

To remove SVP simply delete the SVP 4 Mac.app from Applications.

Additionally if you want to remove all the Homebrew packages including mpv video player run this command from the Terminal:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/uninstall.sh)"

Note that it will remove EVERYTHING from Homebrew, not only mpv dependencies.

Manual installation

• Take at least macOS 12 "Monterey" or later.
• Install Homebrew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Note that on Apple M1 systems this will install native ARM binaries into /opt/homebrew. You can either add /opt/homebrew/bin/ to your PATH, or call '/opt/homebrew/bin/brew' instead of simple 'brew' in the following commands.

• Install mpv (this will also automatically install Vapoursynth) (DO NOT install it via 'brew install --cask mpv' !):

brew install mpv

Note: this step is essential even if you don't want to use mpv at all.

Alternate installation via MacPorts

Use this method if you are still on macOS 11 or earlier OR just don't like Homebrew ;)

Prebuilt mpv package

!!! DO NOT INSTALL THIS if you're using MacPorts already! Go to the next section and just install mpv in your existing MacPorts installation.

Just install our prebuilt mpv 0.37, and you're good to go. Works with macOS 10.15 "Catalina" or later.

Full MacPorts installation

• Install full Xcode from the App store, run it for the first time, accept user agreement, install whatever it wants to install.
• Install MacPorts
• Install mpv:

sudo port install mpv +vapoursynth +libmpv

This will install everything into /opt/local - i.e. /opt/local/bin/mpv.

Problems:

• mpv 0.38 won't build on Big Sur or earlier. It's possible to install previous version such as mpv 0.37 instead:

sudo ln -s /opt/local/bin/rst2man-3.12 /opt/local/bin/rst2man-3.12.py
git clone --single-branch https://github.com/macports/macports-ports.git
cd macports-ports
git checkout 772d1aa5a7c314db69fa709e04d37e7025467b40
cd multimedia/mpv
sudo port install +vapoursynth

Apple M1+ (Apple Silicon, ARM64) systems

Though SVP 4 Mac is an Intel application, it fully supports native ARM video players.

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.

# 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

VLC configuration

SVP's plugin for VLC replaces the "deinterlace" filter.

Install SVP's plugin via SVP main menu -> Utilities -> SVP in VLC.

macOS 12 Ventura or later: you have to allow SVP to modify apps on your Mac - go to System settings -> Privacy & security -> App Management and turn it on for SVP 4 Mac.

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

Streaming to SVPlayer

Required SVPcast extension is enabled by default. You can stream to any Chromecast-compatible device or to the SVPlayer application available on Apple TV, iOS, Android.

Quick start:

• SVP menu -> Streaming -> Web UI -> Enable
• SVP menu -> Streaming -> Web UI -> Choose videos folder…
• Open SVPlayer, find out the SVPlayer location is available, browse it like any other folder.

More information