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

Downloading SysDVR-Client

Go to the Releases tab, download and extract the SysDVR-Client.7z file, it's a single release that works an all the supported operating systems.
Among the various files it contains two executables:

• SysDVR-Client.exe (or SysDVR-Client.dll on linux and mac) 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.

Since 5.5 the releases also contain the SysDVR-Client.flatpak file, this is a flatpak package that can be used to easily install SysDVR-Client on linux.

Windows setup

1. Download and install latest .NET. Make sure to get the x64 version direct link.
   • 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 flatpak 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 6 or newer.
   • You need .NET 6 or newer, mono and .NET core will not work
   • Important: if you use an Apple silicon (arm) mac do NOT install the default intel (x64) version but open the dropdown and download the native arm version
2. Install ffmpeg brew install [email protected]
   • This command should work fine most of the times, if you encounter issues you can try to install ffmpeg from source, first uninstall it brew uninstall ffmpeg then run brew install [email protected] --build-from-source
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