Virtual Display Driver

This is a Windows driver made in Rust which creates a virtual desktop.

It has many uses, such as:

A private virtual desktop for VR use
For remote desktops
For screenshare presentations, to give you more workspace with a second monitor
Getting a higher resolution (or higher refresh rate) display when you don't have a physical one on-hand (though note you can only use it in software/VR)
Other uses? Let me know!

Supports: Windows 10 2004+ (x64 only)

For any bug reports, please see the debugging or reporting crashes section to get the panic message for the bug report

Features

Multiple monitors (up to 10)
Multiple resolutions per monitor
Multiple refresh rates per resolution
App to configure them all, disable all/individual monitors

preview.mp4

How to install

Go to the releases section for the latest driver.
Download (you may receive a warning, just press accept)
Install certificate
Run the msi installer
The driver will be installed, started, and you can find a shortcut to the control app in the start menu, named "Virtual Display Driver Control"

How to install portable version

Go to the releases section for the latest driver.
Download (you may receive a warning, just press accept)
Install certificate
Install install.reg
Open device manager
- click on any item in the list
- go to Actions -> Add legacy hardware
- next on Install hardware that I manually select from a list
- next on `Show all devices
- click on Have Disk... and select the folder with the driver files file in it
- finish the setup
The driver will be installed and started. The control panel exe you see in the folder will work from anywhere you put it.

Installing the certificate

The certificate needs installation for Windows to accept the driver

In your downloaded zip, there is a file DriverCertificate.cer and install-cert.bat
Open a cmd prompt as admin and run install-cert.bat
Verify the certificate installed properly. *

* If the certificate didn't install properly, then the driver won't install. If driver installation fails, this is most likely the reason why; and you should check that the certificate is actually installed. Try manually running the commands in the install-cert.bat file (below) in an admin cmd prompt to make sure the certificate is installed correctly (for both root and TrustedPublisher stores). The commands will tell you if they successfully added it or not.

certutil -addstore -f root "DriverCertificate.cer"
certutil -addstore -f TrustedPublisher "DriverCertificate.cer"

You can also search for Manage Computer Certificates, look in Trusted Publishers and Trusted Root Certification, you will see the certificate named DriverCertficate.

You can manually import it by right clicking on the menu entry -> All Tasks -> Import, and following the instructions in the import wizard

Why is it so difficult? The reason I didn't add auto certificate installation is because I believe certificates are a personal thing, and should not be added automatically without the users knowledge.

Updating

Download the new release
Install the msi package

Using the app

Please see the wiki for instructions on using the app.

How to build

Download and install Visual Studio (use the 2022 edition)
- Select and install the Desktop development with C++ workload as well as Windows SDK
Install the WDK
Install cargo-make if you don't have it
Install cargo-target-dir

You can build it with cargo make build (debug) or cargo make -p prod build (release), and check the target/output directory for all the files

To build the installer, do a cargo make build-installer (dev) or cargo make -p prod build-installer (release). In order to build the installer, you need wix toolset installed and on Path

... Or, fork my project and build it with github actions. You will require 2 repository secrets:

PRIVATE_KEY - a windows code signing pfx certificate encoded in base64 (use certutil -encode)
PRIVATE_KEY_PASSWORD - self explanatory

Debugging or Reporting Crashes

If you want to debug a problem or need to report a crash, follow the below instructions:

All messages from the driver are logged in the Windows Event Viewer.

Open the Event Viewer
Go to Windows Logs -> Application
You will see logs for the driver under the source name VirtualDisplayDriver

If you want to make them easier to see

right click on Custom Views
- click Create Custom View...
  - select By source
  - find and select VirtualDisplayDriver in the list, then press Ok
  - type in VirtualDisplayDriver for the name, and press Ok
You should now see any log messages under the Custom Views section for VirtualDisplayDriver

Contributions

All contributions are welcome! If you have any questions, feel free to post in the project Discussion section

jdjingdian/virtual-display-rs