Skip to content

assdaxan/TWindbg

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Python 3 MIT License

TWindbg for WinDbg-Preview

PEDA-like debugger UI for WinDbg-Preview

  • JMP Highlight context img

  • Navigator context img

Original Repository

Introduction

This is a windbg extension ( using pykd ) to let user having a PEDA-like debugger UI in WinDbg.
It will display the following context in each step/trace:

  • Registers
  • Disassembled code near PC
  • Contents of the stack pointer ( with basic smart dereference )

It also supports some peda-like commands ( see the support commands section )

For now it supports both x86 & x64 WinDbg.

Dependencies

  • Python 3

I decided to drop the support of Python2.7 since it has reached the EOL. I believe the project is Python2/3 compatible, however there might exist some issues in pykd and can cause different behavior in Python2/3. Since now the project will only be tested on Python3, I strongly suggest using TWindbg on Python3 instead of Python 2.7. If you still want to use it on Python 2.7, feel free to fork the project and do the development.

Installation

  • Install Python3
  • Add Windows System PATH
    • Variable Name : PATH
    • Variable Value : %LOCALAPPDATA%\Dbg\EngineExtensions\
  • Install pykd
    • Download Pykd-Ext, unpack pykd.dll to the %LOCALAPPDATA%\Dbg\EngineExtensions\ directory.
      • This will allow you to run python in Windbg.
    • In the Windbg command line, enter command .load pykd to load the pykd module.
    • Enter !pip install pykd to install the pykd python package.
      • Upgrade the pykd module with command !pip install --upgrade pykd.
      • If something went wrong during the installation with pip install, try installing the wheel package instead of the one on PyPI. You can download the wheel package here.
  • Download the repository
  • Copy the TWindbg folder into %LOCALAPPDATA%\Dbg\EngineExtensions\ & %LOCALAPPDATA%\Dbg\EngineExtensions32\

Usage

Launch TWindbg manually

  • Open an executable or attach to a process with WinDbg
  • Use .load pykd to load the pykd extension
  • Use !py -g TWindbg\TWindbg.py to launch TWindbg

Support Commands

  • TWindbg: List all the command in TWindbg
  • ctx: Print out the current context
  • tel / telescope: Display memory content at an address with smart dereferences

Note

Maybe ( just maybe ) I'll add more command to make WinDbg behave more like PEDA ( or other debugger like pwndbg, GEF... ) in the future.

About

PEDA-like debugger UI for WinDbg

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%