SysDVR Client setup

SysDVR-Client is a PC application that acts as a bridge between SysDVR and your video player, it's needed to improve performances by using some custom-built streaming protocols.

If you encounter any issue check the troubleshooting page

Setting up SysDVR-Client

Go to the Releases tab, download and extract the SysDVR-Client.7z file, among the various files it contains two executables:

• SysDVR-Client.exe this is the actual client. It's a command line application and requires to be launched via terminal or cmd on Windows.
• SysDVR-ClientGUI.exe this is a GUI launcher for SysDVR-Client, this is Windows-only and it's meant to make things easier for less experienced users.

Windows setup

1. Download and install latest .NET. Make sure to get the x64 version.
   • You must install .NET 6 or newer, older versions like framework or 5 won't work.
2. This is not always needed but you may need to install latest x64 MSVC libs from Microsoft
3. You should be ready, launch SysDVR-Client.exe from cmd or double click SysDVR-ClientGUI.
   • SysDVR-ClientGUI is a user-friendly GUI for SysDVR-Client that will automatically configure streaming modes and create shortcuts for them.

Linux setup

Since 5.5 SysDVR-Client comes with a flatpak package, however this is still experimental and only works for x64 systems in case of issues you can try the manual install.

The install commands provided here are for the default Ubuntu package manager, if you use a different distro you'll have to find equivalent commands on your own.

Arm devices such as Raspberry Pi 3 and 4 are supported only with manual install, support depends on the availability of .NET, older boards such as Raspberry Pi 2 or 1 are not supported by .NET.

Flatpak install

1. Install flatpak from your package manager sudo apt install flatpak
2. Download SysDVR-Client.flatpak from the Releases tab
3. Install the flatpak flatpak --user install SysDVR-Client.flatpak

You can now launch SysDVR-Client by running flatpak run com.github.exelix11.sysdvr, if you want you can create an alias for it.

Note that the guide uses SysDVR-Client to launch the client, since you installed it from flatpack you will have to use flatpak run com.github.exelix11.sysdvr instead

Mnaual install

1. Download and install .NET.
   • You need .NET 6 or newer, mono and .NET core will not work
   • Microsoft provides packages for the most common package managers and distros
2. Install SDL2 sudo apt install libsdl2-dev
3. Install ffmpeg sudo apt install ffmpeg
   • You need ffmpeg 5.1.x
   • In particular we need libavcodec59, this may not be available in your package manager, if that's the case you'll have to build ffmpeg from source
   • Failing to install the exact version of ffmpeg will result in a module not found error when you launch SysDVR-Client
4. You should be ready, open a terminal in the same folder where you extracted the zip and check if it works by running dotnet SysDVR-Client.dll --help

Note that the guide uses SysDVR-Client to launch the client, since you are not on windows you will have to use dotnet SysDVR-Client.dll instead with the terminal opened in the same folder as the extracted zip

MacOS setup

The install commands use brew, if you use a different package manager you'll have to find equivalent commands on your own.

1. Download and install .NET.
   • You need .NET 6 or newer, mono and .NET core will not work
   • You must install the native .NET version for your device: if you have an apple silicon mac download the arm64 version, if you have an intel mac download the x64 version. Running SysDVR with rosetta will not work
2. Install ffmpeg brew install ffmpeg@5.1.2
3. Install SDL2 brew install SDL2
4. Install libusb brew install libusb
5. You should be ready, open a terminal in the same folder where you extracted the zip and check if it works by running dotnet SysDVR-Client.dll --help

Note that the guide uses SysDVR-Client to launch the client, since you are not on windows you will have to use dotnet SysDVR-Client.dll instead with the terminal opened in the same folder as the extracted zip