DOCSEARCHbyAlgolia
Submit Docs

Virtual Display Driver Documentation

repository·master·Indexed 25 days ago

https://github.com/virtualdrivers/virtual-display-driver

A Windows driver that creates a virtual monitor for streaming, VR, screen recording, and headless server environments. Supports custom resolutions, refresh rates, and EDIDs. Includes documentation for installation via Virtual Driver Control (VDC), Winget, or manual methods, as well as PowerShell scripts for managing display settings, HDR, and desktop modes. Also contains information on the beta Virtual Audio Driver for emulating playback and input devices.

Tokens
2.9K
Snippets
11
Records
19
Agent score
95%

What's inside Virtual Display Driver

  1. Install the Virtual Display Driver

    master

    You can install the Virtual Display Driver using the Virtual Driver Control (VDC) app or via Winget.

    Method 1: Using Virtual Driver Control (Recommended)

    1. Download the Virtual Driver Control app from the Releases page.
    2. Extract the application to a folder.
    3. Launch the VDC app and click the Install button.

    Method 2: Using Winget

    Run the following command in your terminal:

    winget install --id=VirtualDrivers.Virtual-Display-Driver -e
    winget install --id=VirtualDrivers.Virtual-Display-Driver -e

  2. Use Toggle_VDD.bat to enable or disable the Virtual Display Driver

    master

    The Toggle_VDD.bat utility is a menu-based batch script that allows you to enable or disable the Virtual Display Driver (VDD) without manually using the Windows Device Manager. It provides real-time status updates and detailed device information.

    Requirements

    • OS: Windows 10 or 11
    • Privileges: Administrator privileges are required
    • Dependencies: Uses built-in PowerShell

    Setup and Usage

    To ensure the script has the necessary permissions to modify device states:

    1. Right-click Toggle_VDD.bat and select Properties.
    2. Navigate to the Advanced tab.
    3. Check Run as administrator and click OK.
    4. Double-click the file to launch the menu.

    Menu Options

    Once running, you can select from the following options:

    1. Enable VDD
    2. Disable VDD
    3. Check Status Only
    4. Exit

  3. Install the Virtual Audio Driver

    master

    The Virtual Audio Driver is a beta software that requires manual installation via Device Manager. If you are using a test-signed driver, you must first enable test signing mode in Windows.

    1. Enable Test Signing (if required)

    Run the following command in PowerShell as an administrator:

    bcdedit /set testsigning on

    Note: Production-signed drivers do not require this step.

    2. Manual Installation via Device Manager

    1. Open Device Manager.
    2. Expand Audio inputs and outputs.
    3. In the top menu, select Action > Add Legacy Hardware.
    4. Select Install the hardware that I manually select from a list (Advanced).
    5. Select Sound, video and game controllers.
    6. Click Have Disk... and browse to the location of the VirtualAudioDriver.inf file.
    7. Follow the remaining prompts to complete the installation.

    3. Verify Installation

    • Under Sound, video and game controllers, you should see Virtual Audio Driver (the speaker).
    • Under Audio inputs and outputs, you should see Virtual Mic Driver (the microphone).

  4. Install script dependencies

    master

    To ensure all helper scripts function correctly, you must install the required PowerShell modules (DisplayConfig and MonitorConfig). Use the modules_install.bat script, which opens an elevated PowerShell session to perform the installation.

    Alternatively, you can use set-dependencies.ps1 to verify, install, or import the exact module versions required for your current environment.

    modules_install.bat

  5. Install the Virtual Display Driver manually

    master

    Follow these steps to install the driver using the extracted files. Note that this process involves adding a certificate to your trusted root and manually adding legacy hardware via Device Manager.

    1. Download and Extract: Download the latest release as a zip file and extract its contents.
    2. Trust the Certificate: Run the *.bat file from the extracted folder as an Administrator to add the driver certificate as a trusted root certificate.
    3. Add Hardware via Device Manager:
      • Open Device Manager.
      • Click on any device in the list.
      • Click the Action menu and select Add Legacy Hardware.
      • Select Add hardware from a list (Advanced).
      • Select Display adapters.
      • Click Have Disk....
      • Click Browse... and navigate to the extracted folder to select the .inf file.
    4. Configure Displays: Once installed, go to your system Display Settings to customize the resolution of the new virtual displays. These displays are compatible with Oculus and can be streamed.
    1. Download the latest release as a zip file.
2. As an administrator, Run the *.bat file to add the driver certificate as a trusted root certificate.
3. Don't install the inf. Open device manager, click on any device, then click on the "Action" menu and click "Add Legacy Hardware"
4. Select "Add hardware from a list (Advanced)" and then select Display adapters
5. Click "Have Disk..." and click the "Browse..." button. Navigate to the extracted files and select the inf file.
6. You are done!

  6. Configure the Virtual Speaker

    master

    The Virtual Speaker emulates a playback device for headless servers, remote desktop sessions, or streaming.

    Set as Default Output

    • Go to Sound Settings > Output and select Virtual Audio Driver.
    • Alternatively, use the Volume Mixer to route specific applications to this device.

    Adjust Audio Quality (Sample Rates/Bit Depths)

    1. In Sound Settings, go to Playback Devices.
    2. Right-click Virtual Audio Driver and select Properties.
    3. Navigate to the Advanced tab.
    4. Select a supported format from the list (ranging from 8-bit, 8000 Hz up to 32-bit, 192,000 Hz).

    Enable Spatial Sound

    1. Right-click the device in Sound Settings and select Properties.
    2. Navigate to the Spatial Sound tab.
    3. Enable Windows Sonic for Headphones or other supported formats.

  8. Build the Virtual Display Driver from source

    master

    This project requires the Microsoft Windows Driver Frameworks headers, which are included as a Git submodule.

    To clone the repository with submodules already initialized:

    git clone --recurse-submodules https://github.com/VirtualDrivers/Virtual-Display-Driver.git

    If you have already cloned the repository without submodules, initialize them using:

    git submodule update --init --recursive
    git clone --recurse-submodules https://github.com/VirtualDrivers/Virtual-Display-Driver.git

  11. Configure the Virtual Microphone

    master

    The Virtual Microphone emulates an input device for voice chat, streaming (OBS/XSplit), or software-generated audio injection.

    Set as Default Input

    • Go to Sound Settings > Input and select Virtual Mic Driver.
    • Use the Volume Mixer or application-specific settings to route audio to this device.

    Supported Audio Formats

    You can select the following formats in the device properties:

    • 16-bit, 44,100 Hz
    • 16-bit, 48,000 Hz
    • 24-bit, 96,000 Hz
    • 24-bit, 192,000 Hz
    • 32-bit, 48,000 Hz

    Adjust Input Levels

    • Adjust levels via the Recording tab in Sound Settings or through your specific audio software's device preferences.

  12. Configure Virtual Display settings manually

    master

    While the Virtual Driver Control (VDC) app is the preferred interface, you can manually manage resolutions and functions by editing the vdd_settings.xml configuration file.

    The file is located at: C:\VirtualDisplayDriver\vdd_settings.xml

    C:\VirtualDisplayDriver\vdd_settings.xml