Merge branch 'master' into pr/abs-mouse-relative

Author: danalec

.github/dependabot.yml

@@ -15,4 +15,9 @@ updates:
       interval: "cron"
       cronjob: "30 2 * * *"
       timezone: "America/New_York"
+    groups:
+      vulkan:
+        patterns:
+          - "third-party/Vulkan-*"
+          - "third-party/*/Vulkan-*"
     open-pull-requests-limit: 10

.github/workflows/ci-freebsd.yml

@@ -48,7 +48,7 @@ jobs:
           echo "PROCESSOR_COUNT: $PROCESSOR_COUNT"
 
       - name: Setup FreeBSD
-        uses: vmactions/freebsd-vm@83b151f58c6047089f4c80eb5ba2039d158ce093  # v1.5.3
+        uses: vmactions/freebsd-vm@d0518f912576ae759075aa00fb9fe27037940271  # v1.5.4
         with:
           arch: ${{ matrix.arch }}
           cpu: ${{ steps.processor_count.outputs.PROCESSOR_COUNT }}

branding/github/banner.jpg

@@ -1551,9 +1551,9 @@ editing the `conf` file in a text editor. Use the examples as reference.
     </tr>
     <tr>
         <td>Default</td>
-        <td colspan="2">@code{}
-            (empty - bind to all interfaces)
-            @endcode</td>
+        <td colspan="2">
+            Empty, binds to all interfaces
+            </td>
     </tr>
     <tr>
         <td>Example (IPv4)</td>
@@ -1655,10 +1655,10 @@ editing the `conf` file in a text editor. Use the examples as reference.
     </tr>
     <tr>
         <td>Default</td>
-        <td colspan="2">@code{}
-            (empty - uses built-in defaults: https://localhost, https://127.0.0.1, https://[::1],
-            with configured UI port variants)
-            @endcode</td>
+        <td colspan="2">
+            Empty, uses built-in defaults: https://localhost, https://127.0.0.1, https://[::1],
+            with configured UI port variants
+            </td>
     </tr>
     <tr>
         <td>Example</td>
@@ -2809,6 +2809,40 @@ editing the `conf` file in a text editor. Use the examples as reference.
     </tr>
 </table>
 
+### amd_max_au_size
+
+<table>
+    <tr>
+        <td>Description</td>
+        <td colspan="2">
+            Maximum Access Unit (frame) size for rate control, in bits. This is a last-resort
+            control for capping oversized encoded frames that would otherwise exceed Sunshine's
+            four-block FEC capacity and be sent without FEC protection.
+            @note{This option only applies to H.264 and HEVC when using amdvce [encoder](#encoder).
+            AV1 does not support this option.}
+            @note{The FEC ceiling depends on the negotiated packet size and [fec_percentage](#fec_percentage),
+            not the average bitrate or frame rate. The approximate encoded-payload ceiling is
+            `4 * floor(25500 / (100 + fec_percentage)) * (packet_size - 16) * 8` bits, before
+            allowing for the short frame header or codec-header replacements. With 20% FEC and
+            1024-byte packets, 6400000 bits provides conservative headroom.}
+            @warning{Setting this unnecessarily low can reduce image quality, especially for
+            keyframes. Leave it empty unless oversized frames are actually causing FEC to be skipped.}
+        </td>
+    </tr>
+    <tr>
+        <td>Default</td>
+        <td colspan="2">
+            Empty, uses encoder default.
+            </td>
+    </tr>
+    <tr>
+        <td>Example</td>
+        <td colspan="2">@code{}
+            amd_max_au_size = 6400000
+            @endcode</td>
+    </tr>
+</table>
+
 ### amd_quality
 
 <table>

branding/ms-store/box-art.png

@@ -474,19 +474,29 @@ and enter its device name in the [audio_sink](configuration.md#audio_sink) field
 > Gamepads are not currently supported.
 
 ### Windows
-Sunshine uses libvirtualhid for virtual gamepads on Windows. You must install the
-[Virtual HID Driver](https://github.com/LizardByte/libvirtualhid/releases/latest) separately for full virtual gamepad
-support. ViGEmBus is detected only as a limited fallback for Xbox 360 and DualShock 4 gamepads when libvirtualhid is
-unavailable.
+Sunshine uses libvirtualhid for virtual input on Windows. You must install the
+[Virtual HID Driver](https://github.com/LizardByte/libvirtualhid/releases/latest) separately for a driver-backed Raw
+Input mouse and full virtual gamepad support. ViGEmBus is detected only as a limited fallback for Xbox 360 and
+DualShock 4 gamepads when libvirtualhid is unavailable.
+
+Sunshine requires Virtual HID Driver version `2026.823.352.3` or newer. Earlier releases use incompatible Windows
+control and broker protocols and must be upgraded together with Sunshine's embedded libvirtualhid library. Local
+development driver builds using a `0.0.0.*` version remain supported.
 
 Compared with the ViGEmBus fallback, Virtual HID Driver can create Xbox One, Xbox Series, DualSense, Nintendo Switch
 Pro, and Generic gamepads in addition to Xbox 360 and DualShock 4. It can also expose controller-specific features such
 as motion, touchpads, LEDs, and adaptive triggers when supported. Virtual HID Driver is actively developed and
 supported by the LizardByte team.
 
-The Virtual HID Driver also requires an active machine license. Sunshine shows the current license status and actions
-on the Web UI Troubleshooting page and in the **Virtual HID Driver** system tray submenu. When Sunshine starts on an
-unactivated machine, select its tray notification to open the activation and purchase options in the Web UI.
+With a compatible driver and active license, relative mouse movement, buttons, and scrolling are exposed as a real HID
+mouse so applications using Raw Input can receive them. Absolute mouse positioning continues to use Windows input
+injection. When the driver-backed mouse cannot be created, libvirtualhid retains its legacy SendInput fallback.
+
+The Virtual HID Driver requires an active machine license for driver-backed devices, including gamepads and the Raw
+Input mouse. Sunshine shows the current license status and actions on the Web UI Troubleshooting page and in the
+**Virtual HID Driver** system tray submenu. When Sunshine starts on an unactivated machine, select its tray notification
+to open the activation and purchase options in the Web UI. Sunshine recreates the shared mouse after a successful
+license action, so switching between the HID and SendInput paths does not require restarting Sunshine.
 
 After installing or updating virtual input drivers, it is recommended to restart your computer.
 

branding/ms-store/poster-art.png

@@ -290,22 +290,37 @@ launchctl load -w /Library/LaunchAgents/org.freedesktop.dbus-session.plist
 ## Windows
 
 ### No gamepad detected
-Sunshine uses libvirtualhid for virtual gamepads on Windows. Install the
-[Virtual HID Driver](https://github.com/LizardByte/libvirtualhid/releases/latest) separately for full virtual gamepad
-support. ViGEmBus is detected only as a limited fallback for Xbox 360 and DualShock 4 gamepads when libvirtualhid is
-unavailable. If you use the [ViGEmBus fallback](https://github.com/nefarius/ViGEmBus/releases/latest), you must use
-version 1.17 or newer.
+Sunshine uses libvirtualhid for virtual input on Windows. Install the
+[Virtual HID Driver](https://github.com/LizardByte/libvirtualhid/releases/latest) separately for a driver-backed Raw
+Input mouse and full virtual gamepad support. ViGEmBus is detected only as a limited fallback for Xbox 360 and
+DualShock 4 gamepads when libvirtualhid is unavailable. If you use the
+[ViGEmBus fallback](https://github.com/nefarius/ViGEmBus/releases/latest), you must use version 1.17 or newer.
+
+Sunshine requires Virtual HID Driver version `2026.823.352.3` or newer. Earlier releases use incompatible Windows
+control and broker protocols. The Troubleshooting page reports an older installed package as unsupported and links
+to the current driver release. Local development driver builds using a `0.0.0.*` version remain supported.
 
 Virtual HID Driver adds Xbox One, Xbox Series, DualSense, Nintendo Switch Pro, and Generic gamepads, plus advanced
 controller features such as motion, touchpads, LEDs, and adaptive triggers when supported. Unlike the discontinued
 ViGEmBus project, Virtual HID Driver is actively developed and supported by the LizardByte team.
 
-An active Virtual HID Driver machine license is required before Sunshine can create libvirtualhid gamepads. Follow
-the warning on the Web UI home page, the startup tray notification, or the **Virtual HID Driver** tray submenu to open
-the license section on the Troubleshooting page, where you can activate a key or follow the purchase link.
+An active Virtual HID Driver machine license is required before Sunshine can create driver-backed libvirtualhid
+devices, including gamepads and the Raw Input mouse. Follow the warning on the Web UI home page, the startup tray
+notification, or the **Virtual HID Driver** tray submenu to open the license section on the Troubleshooting page, where
+you can activate a key or follow the purchase link.
 
 After installation, it is recommended to restart your computer.
 
+### Games do not detect mouse input
+With a compatible Virtual HID Driver and active license, Sunshine sends relative mouse movement, buttons, and scrolling
+through a real HID device so games using Raw Input can receive them. Absolute positioning still uses Windows input
+injection. When the driver-backed mouse cannot be created, libvirtualhid falls back to SendInput; the Windows cursor may
+still move even though a game that listens only for Raw Input receives nothing.
+
+Check the Virtual HID Driver version and license sections on the Web UI Troubleshooting page even when controller input
+is disabled. Sunshine recreates the shared mouse after a successful license activation, validation, or deactivation, so
+you do not need to restart Sunshine merely to switch between the HID and SendInput paths.
+
 ### Permission denied
 Since Sunshine runs as a service on Windows, it may not have the same level of access that your regular user account
 has. You may get permission denied errors when attempting to launch a game or application from a non-system drive.

docs/configuration.md

@@ -9,12 +9,12 @@
   },
   "type": "module",
   "dependencies": {
-    "@lucide/vue": "1.31.0",
+    "@lucide/vue": "1.33.0",
     "bootstrap": "5.3.8",
     "date-fns": "4.4.0",
     "marked": "18.0.10",
     "vue": "3.5.41",
-    "vue-i18n": "11.4.8",
+    "vue-i18n": "11.4.9",
     "vue3-simple-icons": "16.10.0"
   },
   "devDependencies": {