regstr - WinDbg UI Extension Samples

English / 日本語

Sample WinDbg UI extensions and command extensions.

This repository contains practical WinDbg extension examples, including RegStr, Command History, and Command Viewer UI extensions, as well as the regstr command extension.

• regstr command extension: If a register value can be interpreted as an ASCII string, it also displays that string
• RegStr UI extension: Displays register values and strings in the RegStr tool window according to the execution state
• Command History UI extension: Retains command history, pin commands, and rerun commands
• Command Viewer UI extension: A command execution window that updates on every step. Supports history and highlighting differences in command output

• Windows 11
• WinDbg 1.2603.20001.0, 1.2606.22001.0
• Windows SDK 10.0.26100.7627
• Visual Studio 2026 18.5.2

Note: regstr extensions support debugging x64 applications only.

Note: regstr_c.dll, regstr_cpp.dll, regstr_cpp2.dll, and regstr_rs.dll have different implementations, but all provide the same functionality. If you use them, use only one of them.

1. Download and extract the prebuilt zip from the Releases page
2. Launch WinDbg, debug any x64 application, and load the DLL with .load <absolute path to the DLL>. The DLL is one of regstr_*.dll
3. Confirm that the !regstr command is available

If you want it to be loaded automatically at startup, copy the entire UserExtensions folder to %LOCALAPPDATA%\DBG\.

Note: Operation is not guaranteed on WinDbg versions other than the one listed above.

RegStr:

Note: RegStr extension supports debugging x64 applications only.

1. Download and extract the prebuilt zip from the Releases page
2. Create a UIExtensions folder under %LOCALAPPDATA%\DBG, and place RegStr.dll inside it
3. When you start WinDbg, a Register string tab will be added. Click the Register string button inside it to open the RegStr window
4. Debug any x64 application, and register information will be displayed in the RegStr window

Command History:

1. Download and extract the prebuilt zip from the Releases page
2. Create a UIExtensions folder under %LOCALAPPDATA%\DBG, and place CommandHistory.dll inside it
3. When you start WinDbg, a Command history button will be added to the View tab. Click it to open the Command History window
4. Debug any application, and the command history will be displayed

Command Viewer:

1. Download and extract the prebuilt zip from the Releases page
2. Create a UIExtensions folder under %LOCALAPPDATA%\DBG, and place CommandViewer.dll and DiffPlex.dll inside it
3. When you start WinDbg, a Command viewer button will be added to the View tab. Click it to open the Command Viewer window
4. Debug any application and enter any command into the text box at the top; the command output will be displayed

Building the C version:

1. Open c\regstr.slnx in Visual Studio
2. Copy engextcpp.cpp and engextcpp.hpp from %PROGRAMFILES(X86)%\Windows Kits\<version>\Debuggers\inc, and modify them so they can be compiled
3. Build (this produces regstr_c.dll, regstr_cpp.dll, and regstr_cpp2.dll)

Building the Rust version:

1. Command extension: In the rust folder, run cargo build --release (this produces regstr_rs.dll)

Building RegStr:

1. Open ui\RegStr\RegStr.slnx in Visual Studio
2. Build (this produces RegStr.dll)

Building Command History:

1. Open ui\CommandHistory\CommandHistory.slnx in Visual Studio
2. Build (this produces CommandHistory.dll)

Building Command Viewer:

1. Open ui\CommandViewer\CommandViewer.slnx in Visual Studio
2. Build (this produces CommandViewer.dll)

For implementation details, including how to create WinDbg UI extensions, please refer to our blog post How to implement WinDbg extensions (in Japanese): Part 1 - Command Extension, Part 2 - UI Extension, Part 3 - Practical UI Extensions.

Apache License, Version 2.0