Installing svtplay-dl is pretty simple. Follow the instuctions for your OS and you should be up and running in no time.


If you have macOS and Homebrew you can install with:

brew install svtplay-dl

For postprocessing of video files, also install ffmpeg:

brew install ffmpeg

Debian and Ubuntu

The included repository in Debian and Ubuntu is very outdated. The recommended way is to use our own repo.

Add the PGP release keys:

curl -s | sudo apt-key add -

Add the release channel to your APT sources:

echo "deb svtplay-dl release" | sudo tee /etc/apt/sources.list.d/svtplay-dl.list

Update and install svtplay-dl:

sudo apt-get update
sudo apt-get install svtplay-dl

For postprocessing of video files, also install ffmpeg:

sudo apt-get install ffmpeg


There is an compiled .exe file on the download page, but our recommended way is to use bash on Ubuntu on Windows included in Windows 10. From there, install in the same way as for Ubuntu above.

Since the “home” directory is separate in bash, make a link to your Windows home directory’s Videos folder (for example) to your “Ubuntu’s” home directory.

ln -s /mnt/c/Users/your-windows-username/Videos ~/videos

Other systems with python

pip install svtplay-dl

Any UNIX (Linux, BSD, macOS, etc.)

# download with curl
sudo curl -L -o /usr/local/bin/svtplay-dl

# make it executable
sudo chmod a+rx /usr/local/bin/svtplay-dl

From source

Installing from source is fairly straight forward. First clone the repository:

git clone

To install svtplay-dl, navigate to the directory where you cloned the source and run:

sudo make install

# to test the installation
svtplay-dl --version

Install FFmpeg from source

If you are using Ubuntu you can install ffmpeg’s prerequisites like this:

sudo apt-get install autoconf automake build-essential cmake git libass-dev libfreetype6-dev libsdl2-dev libssl-dev libtheora-dev libtool libva-dev libvdpau-dev libvorbis-dev libxcb1-dev libxcb-shm0-dev libxcb-xfixes0-dev pkg-config texinfo wget zlib1g-dev
sudo apt-get install yasm libx264-dev libx265-dev libvpx-dev libfdk-aac-dev libmp3lame-dev libopus-dev librtmp-dev libxvidcore-dev ocl-icd-opencl-dev

Then clone from either GitHub’s mirror or FFmpeg’s official repository.

Compiling time depends on your computer, but around 10 minutes is normal.

git clone
./configure --enable-pthreads --enable-version3 --enable-avresample --enable-gpl --enable-libass --enable-libfdk-aac --enable-libfreetype --enable-libmp3lame --enable-libopus --enable-librtmp --enable-libvorbis --enable-libvpx --enable-libx264 --enable-libx265 --enable-libxvid --enable-opencl --enable-openssl --enable-nonfree
sudo make install

(FFmpeg’s repo in GitHub is: