Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

libvirtualhid exposes generic HID VHF absolute pointer causing frontends to detect an active lightgun

Open
#5,784 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
45/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Domain
desktop, game-dev

Research direction

The issue is in libvirtualhid driver code that creates a VHF absolute pointer device. Look for the HID descriptor definitions and device instantiation logic in the Sunshine source, likely under src or a platform-specific windows directory. Understand how the virtual HID device is exposed and how its properties (like usage page) cause frontends to detect it as a lightgun. Testing requires building Sunshine on Windows and checking the created HID device with tools like HIDView.

Written by the indexing model from the issue text.

Description

Is there an existing issue for this?
  • I have searched the existing issues
Is your issue described in the documentation?
  • I have read the documentation
Is your issue present in the latest beta/pre-release?

This issue is present in the latest pre-release

Describe the Bug

When connecting via VoidLink with Sunshine configured to use libvirtualhid, the driver instantiates a Virtual HID Framework (VHF) absolute pointing / touch / digitizer device on the host system. Emulation frontends like RetroBat / EmulationStation read this generic raw input pointer ID as an active physical Lightgun (hid vhf), even when no pointer/touch inputs are actively being sent by the client.

Expected Behavior

libvirtualhid should either expose virtual gamepads without forcing a persistent absolute pointing/digitizer HID device node when touch passthrough is unused, or expose HID IDs that identify strictly as standard gamepads/mice rather than triggering generic lightgun/digitizer auto-detection.

Additional Context

This issue occurs if Sunshine is running, even if no client is connected.

Host Operating System

Windows

Operating System Version

11 22H2

Architecture

amd64/x86_64

Package

Windows - exe installer

GPU Type

NVIDIA

GPU Model

RTX 4070 Super

GPU Driver/Mesa Version

617.14

Capture Method

None

Apps

Log output

Online logs

No response

Dominant language
C++
Stars
41.4k
Forks
2.1k
Avg merge
20h 19m
Merged PRs (30d)
125

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from LizardByte/Sunshine

All issues in LizardByte/Sunshine

Similar issues

More C++ issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.