VMMouse for NT 3.x: A Mouse Integration Driver for QEMU/VMware

This project provides a specialized mouse integration driver designed specifically for Windows NT 3.x environments running within QEMU or VMware virtualization platforms.

📌 Project Overview

The vmmouse-nt3 repository is dedicated to improving the mouse experience in legacy Windows NT installations. By implementing a proper integration driver, it eliminates the common "mouse trapping" issues found in virtualized environments.

Compatibility Matrix

The driver targets the following versions of the NT kernel: $\text{Supported OS} \in \{ \text{Windows NT 3.1, Windows NT 3.5, Windows NT 3.51} \}$

---

🛠️ Development & Build Process

To compile the driver, the project utilizes a containerized build environment to ensure consistency.

Build Command:

make docker-build

The build process generates a vmmouse.iso file located in the build/ directory.

---

💿 Installation Guide

Follow these steps to integrate the driver into your virtual machine:

Deployment Checklist

• Mount build/vmmouse.iso to the virtual CD-ROM drive (e.g., D:)
• Execute the installation script
• Perform a system restart

Step-by-Step Instructions

1. Mounting: Insert the ISO into the VM's virtual drive.
2. Execution: Open a command prompt and run: D:\INSTALL.BAT
3. Finalization: Reboot the guest operating system.

Uninstallation

If you need to remove the driver:

1. Run D:\UNINSTALL.BAT
2. Reboot the machine.

Installation Workflow

---

📂 Repository Structure

The project is organized into the following directories and configuration files:

• Directories:
  • .github/ — Contains workflows for CI/CD.
  • instdrv/ — Installation driver logic.
  • scripts/ — Helper scripts.
  • tests/ — Testing suite.
  • vmmouse/ — Core driver source code.
• Configuration & Root Files:
  • .clang-format / .editorconfig — Coding style guidelines.
  • .gitignore — Git exclusion list.
  • Dockerfile — Container definition for building.
  • LICENSE — MIT License.
  • Makefile — Build automation.
  • README.md — Project documentation.

---

📊 Repository Statistics

Topics: qemu, vmware-guest, windows-nt-31, windows-nt-35, windows-nt-351