An Interactive Hex-Rays Microcode Explorer
Lucid is a developer-oriented IDA Pro plugin for exploring the Hex-Rays microcode. It was designed to provide a seamless, interactive experience for studying microcode transformations in the decompiler pipeline.
This plugin is labeled only as a prototype & code resource for the community. Please note that it is a development aid, not a general purpose reverse engineering tool.
Lucid is a cross-platform (Windows, macOS, Linux) Python 2/3 plugin. It takes zero third party dependencies, making the code both portable and easy to install.
From your disassembler's python console, run the following command to find its plugin directory:
Copy the contents of this repository's
/plugins/folder to the listed directory.
Restart your disassembler.
This plugin is only supported for IDA 7.5 and newer.
Lucid will automatically load for any architecture with a Hex-Rays decompiler present. Simply right click anywhere in a Pseudocode window and select
View microcodeto open the Lucid Microcode Explorer.
By default, the Microcode Explorer will synchronize with the active Hex-Rays Pseudocode window.
Lucid makes it effortless to trace microinstructions through the entire decompiler pipeline. Simply select a microinstruction, and scroll (or click... if you must) through the microcode maturity layer list.
Watch as the explorer stays focused on your selected instruction, while the surrounding microcode landscape melts away. It's basically magic.
Cursor tracing can operate at a sub-operand / sub-instruction level. Placing your cursor on different parts of the same microinstruction can trace sub-components back to their respective origins.
If the instructions at the traced address get optimized away, Lucid will attempt to keep your cursor in the same approximate context. It will change the cursor color from green to red to indicate the loss of precision.
As the Hex-Rays microcode increases in maturity, the decompilation pipeline begins to nest microcode as sub-instructions and sub-operands that form tree-based structures.
You can view these individual trees by right clicking an instruction and selecting
As this is the initial release, there will probably a number of small quirks and bugs. Here are a few known issues at the time of release:
If you encounter any crashes or bad behavior, please file an issue.
Time and motivation permitting, future work may include:
I welcome external contributions, issues, and feature requests. Please make any pull requests to the
developbranch of this repository if you would like them to be considered for a future release.