+0
Daily
301
stars
32
forks
5
watchers
120
prs
36
issues
20
releases
README
IDA Domain The IDA Domain API is a new open-source Python API designed to make scripting in IDA simpler, more consistent, and more natural. This is a first step in a much longer journey. It’s not the finish line, but a foundation for ongoing collaboration between Hex-Rays and the reverse engineering community. Over time, the Domain API will expand to cover more areas of IDA, gradually becoming the main entry point for scripting and plugin development. The Domain in Domain API refers to the domain of reverse engineering. Concepts like functions, types, cross-references, and more are first-class citizens in this API, giving you cleaner, domain-focused abstractions for common tasks. The Domain API sits on top of the IDA Python SDK, complementing it rather than replacing it. You can use both side by side—combining the clarity and simplicity of Domain API calls with the full flexibility of the SDK when needed. Compatibility: Requires IDA Pro 9.1.0 or later 🚀 Key Features - Domain-focused design – Work directly with core reverse engineering concepts like functions, types, and xrefs as first-class citizens. - Open source from day one – Read the code, suggest improvements, or contribute new ideas. - Pure Python implementation – No compilation required, works with modern Python versions. - Compatible by design – Use alongside the IDA Python SDK without conflicts. - Developer-centric – Reduce boilerplate and streamline frequent tasks. - Independently versioned – Upgrade at your own pace and pin versions for stability. - Simple installation – Get started with a single pip install. 📦 Installation Prerequisites IDA Pro Version: The IDA Domain library requires IDA Pro 9.1.0 or later. The idapro Python module needs to know where IDA Pro is installed. The location is stored in a per-user config file (%APPDATA%\Hex-Rays\IDA Pro\ida-config.json on Windows, ~/.idapro/ida-config.json on Linux/macOS). - If IDA was installed via HCLI: the install path is configured automatically — no further setup is required. - Otherwise: run the py-activate-idalib.py activation script that ships with IDA once. It auto-detects the install directory from its own location and writes it to the per-user config. The script normally lives in /idalib/python/: Linux/macOS: bash python3 "/path/to/ida/idalib/python/py-activate-idalib.py" Windows: cmd python "C:\Program Files\IDA Professional 9.1\idalib\python\py-activate-idalib.py" You can also pass -d to point at a specific IDA installation explicitly. Install from PyPI bash pip install ida-domain Overriding the IDA install directory with IDADIR To override the configured install directory for a single session or script — for example to test a specific IDA build, switch between multiple installed versions, or in CI — set the IDADIR environment variable before importing idapro: Linux/macOS: bash export IDADIR="/path/to/your/ida/installation" Windows: cmd set "IDADIR=C:\Program Files\IDA Pro
Top issues
#131Add an API for switches / jump tables4 comments · 2026-10-06#118DeprecationWarning in functions.py1 comments · 2026-08-29#43Add APIs for accessing detailed intruction information1 comments · 2026-01-27#157Suggestion: Be able to load ida_domain without loading all IDA plugins0 comments · 2026-11-07#156ida_domain fails to open an old IDB if there have been a conversion before and the I64 is already there.0 comments · 2026-11-07#117Per-call overhead of check_db_open / flag and dataclass wrapping dominates bulk iteration0 comments · 2026-08-27#53CI/CD: Enforce minimum Python version for test & release, and test across supported range0 comments · 2026-03-02#52Increase test coverage0 comments · 2026-03-02
Discussions
#10Add high-level Xrefs3 comments · 2025-09-09#8Introducing UI additions1 comments · 2025-08-28#7Welcome to ida-domain Discussions!0 comments · 2025-08-28
Latest release
v0.6.0 v0.6.0 2026-11-10v0.6.0 (2026-11-10) _Changes since v0.5.0, including those shipped in v0.5.1._ Added - Analysis API – db.analysis: enable or disable the auto-analyzer, wait for it, and schedule or cancel work on addresses and ranges (114). - License API – db.license / License: query the active license, add-ons and features, check out, borrow and return seats. (122, 128). - Synthetic strings – db.strings now lists strings that do not exist in the bytes, such as those reconstructed by the decompiler (121, 150). - Functions – set_start / set_end, update, reanalyze, is_outlined / set_outlined, apply_de