Enable EVDI virtual display support in Linux builds with two-phase encoder validation

.github/workflows/ci-archlinux.yml

@@ -64,6 +64,68 @@
             xorg-server-xvfb
           pacman -Scc --noconfirm
 
+      - name: Install EVDI library from source
+        shell: bash
+        run: |
+          # Install build dependencies
+          pacman -S --needed --noconfirm libdrm make gcc
+
+          # Create a build directory in builder's home
+          mkdir -p /home/builder/evdi-build
+          chown -R builder:builder /home/builder/evdi-build
+
+          # Clone evdi from official DisplayLink repository at tag v1.14.11
+          cd /home/builder/evdi-build
+          sudo -u builder git clone --depth 1 --branch v1.14.11 https://github.com/DisplayLink/evdi.git
+          cd evdi/library
+
+          # Build the library as builder user
+          sudo -u builder make
+
+          # Install the library and headers (as root)
+          make install PREFIX=/usr
+
+          # Ensure header is in the correct location
+          cp -f evdi_lib.h /usr/include/
+
+          # Ensure library is in the correct location (evdi makefile might put it elsewhere)
+          if [ -f /usr/local/lib/libevdi.so ]; then
+            cp -f /usr/local/lib/libevdi.so* /usr/lib/ || true
+          fi
+
+          # Update library cache
+          ldconfig
+
+          # Verify installation
+          ls -la /usr/lib/libevdi.so* || echo "Warning: libevdi.so not found in /usr/lib"
+          ls -la /usr/include/evdi_lib.h || echo "Warning: evdi_lib.h not found in /usr/include"
+
+          # Create pkg-config file for cmake to find evdi
+          mkdir -p /usr/lib/pkgconfig
+          cat > /usr/lib/pkgconfig/evdi.pc << 'EVDI_PC_EOF'
+          prefix=/usr
+          exec_prefix=${prefix}
+          libdir=${exec_prefix}/lib
+          includedir=${prefix}/include
+
+          Name: evdi
+          Description: Extensible Virtual Display Interface
+          Version: 1.14.11
+          Libs: -L${libdir} -levdi
+          Cflags: -I${includedir}
+          EVDI_PC_EOF
+
+          # Verify pkg-config works
+          pkg-config --exists evdi && echo "pkg-config: evdi found" || echo "pkg-config: evdi NOT found"
+          pkg-config --modversion evdi || true
+          pkg-config --libs evdi || true
+          pkg-config --cflags evdi || true
+
+          # Clean up
+          cd /
+          rm -rf /home/builder/evdi-build
+          rm -rf /home/builder/evdi-build
+
       - name: Checkout
         uses: actions/checkout@v6
 
@@ -133,12 +195,14 @@
 
           # Export PKGBUILD options so they're available to makepkg
           export _use_cuda="${_use_cuda}"
+          export _use_evdi="true"
           export _run_unit_tests="${_run_unit_tests}"
           export _support_headless_testing="${_support_headless_testing}"
 
           # Build the package as builder user (pass through environment variables)
           sudo -u builder env \
             _use_cuda="${_use_cuda}" \
+            _use_evdi="true" \
             _run_unit_tests="${_run_unit_tests}" \
             _support_headless_testing="${_support_headless_testing}" \
             makepkg -si --noconfirm

.github/workflows/ci-linux.yml

@@ -50,6 +50,7 @@ jobs:
 
           sudo apt-get install -y \
             libdrm-dev \
+            libevdi-dev \
             libfuse2 \
             libgl-dev \
             libwayland-dev \

cmake/compile_definitions/linux.cmake

@@ -113,9 +113,11 @@ if(${SUNSHINE_ENABLE_EVDI})
         list(APPEND PLATFORM_TARGET_FILES
                 "${CMAKE_SOURCE_DIR}/src/platform/linux/evdi.h"
                 "${CMAKE_SOURCE_DIR}/src/platform/linux/evdi.cpp")
+        message(STATUS "EVDI virtual display support enabled")
     else()
-        message(WARNING "EVDI library not found. Virtual display support will not be available.
-                        Install libevdi-dev or build evdi from https://github.com/DisplayLink/evdi")
+        message(FATAL_ERROR "EVDI library not found but SUNSHINE_ENABLE_EVDI is ON. "
+                           "Install libevdi-dev or build evdi from https://github.com/DisplayLink/evdi. "
+                           "To build without EVDI, set -DSUNSHINE_ENABLE_EVDI=OFF")
     endif()
 endif()
 

packaging/linux/Arch/PKGBUILD

@@ -5,6 +5,7 @@
 : "${_run_unit_tests:=false}"  # if set to true; unit tests will be executed post build; useful in CI
 : "${_support_headless_testing:=false}"
 : "${_use_cuda:=detect}" # nvenc
+: "${_use_evdi:=detect}" # evdi virtual display
 
 : "${_commit:=@GITHUB_COMMIT@}"
 
@@ -61,6 +62,7 @@ checkdepends=(
 
 optdepends=(
   'libva-mesa-driver: AMD GPU encoding support'
+  'evdi-dkms: EVDI virtual display kernel module (required for EVDI virtual display support)'
 )
 
 provides=()
@@ -80,6 +82,13 @@ if [[ "${_use_cuda::1}" == "t" ]]; then
   )
 fi
 
+if [[ "${_use_evdi::1}" == "d" ]] && pacman -Qi evdi &> /dev/null; then
+  _use_evdi=true
+fi
+
+# Note: evdi library is built from source in CI before makepkg runs
+# It is not added to makedepends to avoid dependency on AUR packages
+
 if [[ "${_support_headless_testing::1}" == "t" ]]; then
   optdepends+=(
     'xorg-server-xvfb: Virtual X server for headless testing'
@@ -149,6 +158,12 @@ build() {
       fi
     fi
 
+    if [[ "${_use_evdi::1}" == "t" ]]; then
+      _cmake_options+=(-DSUNSHINE_ENABLE_EVDI=ON)
+    else
+      _cmake_options+=(-DSUNSHINE_ENABLE_EVDI=OFF)
+    fi
+
     if [[ "${_run_unit_tests::1}" != "t" ]]; then
       _cmake_options+=(-DBUILD_TESTS=OFF)
     fi

packaging/linux/copr/Sunshine.spec

@@ -47,6 +47,13 @@ BuildRequires: systemd-rpm-macros
 BuildRequires: wget
 BuildRequires: which
 
+# EVDI virtual display support - optional
+# Enable with: rpmbuild --with evdi
+# Note: libevdi-devel may not be available in all repositories
+%if 0%{?_with_evdi}
+BuildRequires: libevdi-devel
+%endif
+
 %if 0%{?fedora}
 # Fedora-specific BuildRequires
 BuildRequires: appstream
@@ -190,6 +197,7 @@ cmake_args=(
   "-DSUNSHINE_ENABLE_WAYLAND=ON"
   "-DSUNSHINE_ENABLE_X11=ON"
   "-DSUNSHINE_ENABLE_DRM=ON"
+  "-DSUNSHINE_ENABLE_EVDI=ON"
   "-DSUNSHINE_PUBLISHER_NAME=LizardByte"
   "-DSUNSHINE_PUBLISHER_WEBSITE=https://app.lizardbyte.dev"
   "-DSUNSHINE_PUBLISHER_ISSUE_URL=https://app.lizardbyte.dev/support"

packaging/linux/flatpak/dev.lizardbyte.app.Sunshine.yml

@@ -39,6 +39,7 @@ modules:
   - shared-modules/libayatana-appindicator/libayatana-appindicator-gtk3.json
   - "modules/avahi.json"
   - "modules/boost.json"
+  - "modules/evdi.json"
   - "modules/libevdev.json"
   - "modules/libnotify.json"
   - "modules/miniupnpc.json"
@@ -73,6 +74,7 @@ modules:
       - -DSUNSHINE_ENABLE_WAYLAND=ON
       - -DSUNSHINE_ENABLE_X11=ON
       - -DSUNSHINE_ENABLE_DRM=ON
+      - -DSUNSHINE_ENABLE_EVDI=ON
       - -DSUNSHINE_ENABLE_CUDA=ON
       - -DSUNSHINE_PUBLISHER_NAME='LizardByte'
       - -DSUNSHINE_PUBLISHER_WEBSITE='https://app.lizardbyte.dev'

packaging/linux/flatpak/modules/evdi.json

@@ -0,0 +1,27 @@
+{
+  "name": "evdi",
+  "buildsystem": "simple",
+  "build-commands": [
+    "make -C library",
+    "make -C library install DESTDIR=/ PREFIX=/app"
+  ],
+  "sources": [
+    {
+      "type": "git",
+      "url": "https://github.com/DisplayLink/evdi.git",
+      "commit": "96d7493e35a227e64c2b8475cd5a5d15d1c1cd7e",
+      "tag": "v1.14.7",
+      "x-checker-data": {
+        "type": "json",
+        "url": "https://api.github.com/repos/DisplayLink/evdi/releases/latest",
+        "tag-query": ".tag_name",
+        "version-query": "$tag | sub(\"^v\"; \"\")",
+        "timestamp-query": ".published_at"
+      }
+    }
+  ],
+  "cleanup": [
+    "/include",
+    "/lib/pkgconfig"
+  ]
+}

scripts/linux_build.sh

@@ -222,6 +222,7 @@ function add_debian_based_deps() {
     "libcurl4-openssl-dev"
     "libdrm-dev"  # KMS
     "libevdev-dev"
+    "libevdi-dev"  # EVDI virtual display
     "libgbm-dev"
     "libminiupnpc-dev"
     "libnotify-dev"
@@ -534,6 +535,7 @@ function run_step_cmake() {
     "-DSUNSHINE_ENABLE_WAYLAND=ON"
     "-DSUNSHINE_ENABLE_X11=ON"
     "-DSUNSHINE_ENABLE_DRM=ON"
+    "-DSUNSHINE_ENABLE_EVDI=ON"
   )
 
   if [ "$appimage_build" == 1 ]; then

src/platform/common.h

@@ -52,7 +52,7 @@
     class path;
   }
 
   namespace process::inline v1 {
     class child;
     class group;
     template<typename Char>
@@ -594,6 +594,15 @@
   // A list of names of displays accepted as display_name with the mem_type_e
   std::vector<std::string> display_names(mem_type_e hwdevice_type);
 
+#if defined(__linux__) && !defined(__ANDROID__)
+  /**
+   * @brief Find a VIRTUAL connector display (typically EVDI) in the KMS display list.
+   * @param hwdevice_type The hardware device type for encoding.
+   * @return The display ID as a string, or empty string if not found.
+   */
+  std::string find_virtual_display(mem_type_e hwdevice_type);
+#endif
+
   /**
    * @brief Check if GPUs/drivers have changed since the last call to this function.
    * @return `true` if a change has occurred or if it is unknown whether a change occurred.