sdbtool 0.9.3

Interact with .sdb (application compatibility shim database) files

sdbtool

A tool for converting Microsoft Application Compatibility Database (SDB) files to XML format.

---

Table of Contents

1. Features
2. Getting Started
3. Contributing

Features

• Parses SDB files used by Windows for application compatibility.
• Converts SDB data into readable XML or JSON format.
• Dump file attributes in SDB-recognizable format
• Useful for analysis, migration, or documentation.
• Pure Python and cross-platform - no native apphelp.dll dependency.

Getting Started

Installation

Sdbtool is available as sdbtool on PyPI.

Invoke sdbtool directly with uvx:

uvx sdbtool sdb2xml your.sdb                        # Convert the file 'your.sdb' to xml, and print it to the console
uvx sdbtool sdb2xml your.sdb --output your.xml      # Convert the file 'your.sdb' to xml, and write it to 'your.xml'
uvx sdbtool sdb2json your.sdb                       # Convert the file 'your.sdb' to json, and print it to the console
uvx sdbtool sdb2json your.sdb --output your.json    # Convert the file 'your.sdb' to json, and write it to 'your.json'
uvx sdbtool sdb2xml old.sdb --target-os 0501        # Resolve tag names as of Windows XP (for older databases)
uvx sdbtool attributes your.exe                     # Show the file attributes as recognized by apphelp in an XML-friendly format
uvx sdbtool info your.sdb                           # Show some details about the SDB file (version, description, ...)

Or install sdbtool with uv (recommended), pip, or pipx:

# With uv.
uv tool install sdbtool@latest  # Install sdbtool globally.

# With pip.
pip install sdbtool

# With pipx.
pipx install sdbtool

Updating an installed sdbtool to the latest version with uv:

# With uv.
uv tool upgrade sdbtool

# With pip.
pip install --upgrade sdbtool

# With pipx.
pipx upgrade sdbtool

Tag names and --target-os

Tag names are not constant across Windows versions: some are renamed (e.g. OS_PLATFORM became GUEST_TARGET_PLATFORM), and some are dropped (e.g. OS_SKU exists on XP but not on Windows 11). sdb2xml / sdb2json therefore accept --target-os <VERSION> to resolve names as of a particular Windows release; without it, names are resolved against the newest known table. An unknown tag is rendered as InvalidTag_0xXXXX.

Contributing

Contributions are welcome! Please open issues or submit pull requests.