Minidump Parser 🔍

A powerful Visual Studio Code extension for analyzing crash dump files (minidump only) and performing postmortem analysis with an intuitive sidebar interface.

🚀 Key Features

🔬 Advanced Crash Analysis: Comprehensive minidump (.dmp) file analysis with stack traces, registers, and memory dumps
🧠 Intelligent Root Cause Detection: Pattern matching to identify common crash causes (null pointer, buffer overflow, stack overflow)
📝 Text-based Crash Enhancement: Enhance text-format crash dumps with symbol information
🎯 Register Tooltips: Interactive hover information for CPU registers with crash analysis insights
📊 Symbol Enhancement: Extract and apply symbols for better crash analysis
🌐 Cross-Platform Support: Works seamlessly on Windows, macOS, and Linux
⚡ Auto-Installation: Automatically installs required analysis tools

📦 Installation

From VS Code Marketplace (Recommended)

Open VS Code → Extensions (Ctrl+Shift+X / Cmd+Shift+X)
Search for "Minidump Parser" → Click "Install"

Quick Start

Install the extension
Click the Minidump Parser icon in the Activity Bar
Open a crash dump file (.dmp) or text-based crash log
Start analyzing!

� Supported File Types

✅ Minidump Files (.dmp, .dump)

Complete crash analysis with stack traces, register dumps, and memory information
Uses minidump_stackwalk for comprehensive analysis

✅ Text-based Crashes (.txt, .crash, .log)

Symbol resolution for addresses in text-based crash logs
Supports macOS crash reports, Android tombstone logs, custom stack traces

🎯 Usage

Click Minidump Parser icon in Activity Bar
Use panel buttons:
- Open Dump File: Analyze .dmp files
- Set Symbol Path: Configure symbol directory
- Extract Symbols: Extract symbols from binaries
- Enhance Stack Trace: Enhance text-based crashes
- Tool Configuration: Install/configure analysis tools

Register Tooltips

Hover over register names (e.g., eax, rsp, pc) in analysis results to view:

Register descriptions and purposes
Current value interpretation
Crash analysis insights
Supported architectures: x86, x64, ARM

⚙️ Configuration

{
    "minidump-parser.symbolPath": "/path/to/your/symbols",
    "minidump-parser.customMinidumpStackwalkPath": "/custom/path/to/minidump_stackwalk",
    "minidump-parser.customNmPath": "/custom/path/to/nm",
    "minidump-parser.language": "en"
}

📋 Requirements

VS Code: Version 1.75.0 or higher
Analysis Tool: minidump-stackwalk (auto-installed)
Symbol Extraction: nm/llvm-nm (auto-installed)

🌍 Contributing Translations

Currently supported: English, Chinese (Simplified)

To add new languages:

Fork repository → Navigate to src/localization/locales/
Create language file (e.g., fr.json)
Translate strings from en.json
Submit pull request

🚀 Development

git clone https://github.com/appledragon/DumpStorm.git
cd DumpStorm
npm install
npm run compile
npm run package  # Creates .vsix file

Minidump Parser

CuiLiAn