reverse-engineering-binaries-with-binary-ninja
Reverse engineers binaries with Binary Ninja using its analysis stack and Python API
v1.0.03 installs+3 in 7 days24 StarsApache-2.0synced 10 hours ago
Install
No NotHoly CLI yet? Install it first.
$ curl -fsSL https://notholy.com/install.sh | sh$ notholy skills install meltedinhex/reverse-engineering-binaries-with-binary-ninjaWrites to ~/.notholy/skills after checking the signature and the SHA-256.
SignatureSigned, ed25519
Package182ca615…afe75e2d
182ca615d95f…ad0cafe75e2d4 files · 2.9 KBScanMedium2 findings
- Executable script shipped with the skillscripts/analyst.py
- Links to outside domains
Sourcegithub.com/meltedinhex/analyst-ai-pack/tree/main/skills/reverse-engineering-binaries-with-binary-ninja@da7600a
On this page
When to Use
- You want to reverse a binary with Binary Ninja and automate analysis via its Python API (function enumeration, IL traversal, annotation, extraction).
- You need to leverage MLIL/HLIL for cleaner analysis of obfuscated code.
Do not use the headless API to execute the sample — Binary Ninja performs static analysis. Run in an isolated environment and treat inputs as malicious.
Prerequisites
- Binary Ninja with the
binaryninjaPython API available (the script degrades gracefully and generates a script skeleton if the API is not importable).
Safety & Handling
- Static analysis does not execute the sample; keep inputs isolated.
Workflow
Step 1: Generate an analysis script skeleton
python scripts/analyst.py skeleton --emit functions,strings --out bn_extract.pyEmits a Binary Ninja Python script that opens a view, iterates functions, and exports
functions/strings to JSON using the real API (open_view, bv.functions, bv.get_strings).
Step 2: Choose the IL level
Use LLIL for close-to-assembly, MLIL for variable/SSA reasoning, and HLIL for readable pseudo-code; traverse instructions and operands programmatically.
Step 3: Automate annotation
Rename symbols (func.name), add comments (bv.set_comment_at), and create tags for findings.
Step 4: Run and aggregate
Execute the script (headless or in the UI console) and aggregate the JSON output.
Validation
- The skeleton uses real API calls (
binaryninja.open_view,bv.functions). - The chosen IL level matches the analysis goal.
- Exported JSON contains plausible functions/strings.
Pitfalls
- Headless licensing differences (Commercial vs Personal) affecting
open_viewavailability. - Confusing IL levels and operand structures across LLIL/MLIL/HLIL.
- Long analysis times on large binaries — scope function ranges.
References
- See
references/api-reference.mdfor the skeleton generator. - Binary Ninja API and IL docs (linked in frontmatter).
Files in this version
references/11.2 KB
- api-reference.md1.2 KB
scripts/12.6 KB
- analyst.py2.6 KB
- LICENSE340 B
- SKILL.md2.9 KB
Permissions
| Permission | Declared | Found by the scan |
|---|---|---|
| Reads files | No | No |
| Writes files | No | No |
| Runs shell commands | Yes | Yes |
| Uses the network | Yes | Yes |
| Uses connectors | No | No |
| Drives a browser | No | No |
Scan findings
Reviewed on Nov 13, 2026
- MediumFile · Executable script shipped with the skillscripts/analyst.py
- InfoLink · Links to outside domains
A clean scan lowers the risk but does not prove a package is safe. Read what you install.
| Version | Published | Commit | SHA-256 | Signature | Permission change |
|---|---|---|---|---|---|
| v1.0.0 | Nov 13, 2026 | da7600a | 182ca615 | Signed | – |
More from meltedinhex
All from this publisher- writing-yara-rules-from-reversed-codemeltedinhex/writing-yara-rules-from-reversed-code4
- validating-detections-with-atomic-testsmeltedinhex/validating-detections-with-atomic-tests4
- writing-suricata-and-snort-rulesmeltedinhex/writing-suricata-and-snort-rules3
- writing-sigma-detection-rulesmeltedinhex/writing-sigma-detection-rules3
More in Reverse engineering and fuzzing
See the categoryAsk anything your scope allows.
Create an account, add credits and ask the first question in the chat or the terminal.
- 1/3
Create the account
Individual or company. You can switch to a company later without losing balance or keys.
IndividualCompany - 2/3
Add credits
By card. Pay per token, no subscription.
$5.00minimum deposit - 3/3
Ask
In the chat, or install the CLI and run notholy login in your terminal.
$ notholy login