HIDMaestro Documentation

Ship a controller in minutes. Trace it to the wire.

HIDMaestro creates virtual game controllers that look like real hardware to Windows. These docs serve two readers at once. Start and the SDK pages get an application developer to a live controller fast. The Technical Reference goes as deep as IOCTL dispatch tables and shared memory layouts, for people who want to know exactly what the driver does.

Get started Technical Reference

New here

Start

Reference the SDK, install the driver, and create your first virtual controller. No prior knowledge assumed.

The API

SDK

The public C# surface: contexts, controllers, descriptors, force feedback, output passthrough, and name overrides.

Every device

Profiles

The JSON profile system, 228 built-in controllers, custom and cloned devices, and the extractor that captures yours.

Something broke

Troubleshooting

Symptoms, causes, and fixes for driver installs, missing devices, XInput slots, and output that never arrives.

Go deep

Technical Reference

Architecture, driver internals, the shared memory protocol, PnP lifecycle, and how every gaming API is satisfied.

What HIDMaestro is

A C# SDK and matching UMDF2 driver. Add the SDK to your app, call HMContext.InstallDriver() once, and HMContext.CreateController(profile) whenever you need a virtual gamepad. It replaces ViGEmBus and vJoy with one user-mode driver, 228 embedded profiles, runtime-built custom profiles, HID PID 1.0 force feedback, and live-swap teardown that does not leak PnP state.

What HIDMaestro is not

A standalone app. There is no UI to drive HIDMaestro on its own. Consumers like PadForge wrap the SDK with their own input pipeline. If you want to use HIDMaestro through a UI, install PadForge.

HIDMaestro is free and open source, MIT licensed. The code, issues, and releases live at github.com/hifihedgehog/HIDMaestro.