# bootleg/ret-sync

ret-sync is a set of plugins that helps to synchronize a debugging session (WinDbg/GDB/LLDB/OllyDbg2/x64dbg) with IDA/Ghidra/Binary Ninja disassemblers.

Repository: https://github.com/bootleg/ret-sync
Canonical: https://ross.abutalabs.com/products/ret-sync
Language: C
License: GPL-3.0
License Family: copyleft
Topics: reverse-engineering, debugger, disassembler, software-analysis, ida-pro, ghidra, ida-plugin, binaryninja
Last push: 2026-02-15T09:12:10+00:00

## Health v2 (maintenance only)
Score: 53/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 67, release rhythm 8, longevity 100
- inputs: {"age_days": 3888, "days_push": 199, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2378, forks 307 (observed 2026-08-28T04:06:42.198481+00:00)

## What it is
ret-sync is a set of plugins that synchronize a debugging session (WinDbg, GDB, LLDB, OllyDbg, x64dbg) with disassemblers (IDA, Ghidra, Binary Ninja). It combines static and dynamic analysis by keeping disassembler views in sync with the debugger's live state, including automatic ASLR rebasing.

## Use cases
- synchronize IDA graph view with a live WinDbg debugging session
- trace execution in Ghidra while debugging with GDB
- debug malware with x64dbg while following along in a disassembler
- rebase addresses on-the-fly to deal with ASLR during dynamic analysis
- sync multiple IDBs at once to trace across multiple modules
- pass debugger comments and command output into the disassembler

## When to choose
- you want to combine static disassembly with live dynamic debugging
- you need ASLR-aware address synchronization between debugger and disassembler
- you work across multiple hosts or VMs with debugger and disassembler separated
- you need support for many debugger/disassembler combinations from one tool

## When to avoid
- you only do static analysis without a debugger
- you use a disassembler or debugger not on the supported list
- you need a fully integrated single-tool reversing environment

## Facets
- artifact type: plugin
- maturity: active
- function: reverse-engineering, security, developer-tools
- domain: reverse-engineering, security, developer-tools
- platform: windows, cross-platform
- tags: debugger-plugin, disassembler, ida-pro, ghidra, binary-ninja, windbg, gdb, lldb, x64dbg, dynamic-analysis, static-analysis, linux, macos

## Member repositories
- bootleg/ret-sync (main) score 53

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:42.198481+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:34:53.825456+00:00, confidence not recorded.
  - readme: https://github.com/bootleg/ret-sync (fetched 2026-08-28T04:06:42.198481+00:00, sha 459aec062a33)
- Data as of 2026-08-30T08:39:29.467469+00:00.
