BinSync

BinSync Logo

BinSync is a decompiler collaboration tool built on the Git versioning system to enable fined-grained reverse engineering collaboration regardless of decompiler. BinSync is built by mahaloz, the angr team, and the SEFCOM research lab. It's also due in large part to its use by the Shellphish hacking team.

All good decompilers share common objects called Reverse Engineering Artifacts (REAs). These REAs are the center of BinSync's syncing ability. Here are the supported REAs:

  • Function headers (symbol, args, type)
  • Stack Variables (symbol, type)
  • Structs
  • Enums
  • Comments

Note: all types support user-created types like structs.

Binja Sync

Join our discord below for more online help:

Discord

Quick Start

For all installs, it's best to use our two-part installer with Python:

pip3 install binsync && binsync --install

BinSync is also available in the Binary Ninja plugin manager. If you plan on using BS with Ghidra, you must launch it in PyGhidra mode. If you plan on using extra BS features, like the ChatGPT User, install the package like this: pip3 install binsync[extras], which will install extra packages for support. For full install information, please read our quickstart docs.

For developers, install the package to be editable (-e) and make sure pip>=23.0.0.

Supported Platforms

  • IDA Pro: >= 8.4 (if you have an older version, use BinSync v4.10.1)
  • Binary Ninja: >= 2.4
  • angr-management: >= 9.0
  • Ghidra: >= 12.0 (PyGhidra mode)

All versions require Python >= 3.10 and Git installed on your system. Ghidra support is still very much in early stage, so only expect the minimal features like artifact name syncing and comments.

Decompiler Support Progress

Although we support the decompilers in the earlier section, not every decompiler is supported at the same level of syncing. To understand the difference between artifact support, pull, push, and auto push, read our decompiler use introduction.

IDA Pro

Operations     Function Headers     Stack Vars     Global Vars     Structs     Enums     Comments    
Symbols :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Types :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Pull :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Push :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Auto Push :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:

IDA Sync

Binary Ninja

Operations     Function Headers     Stack Vars     Global Vars     Structs     Enums     Comments    
Symbols :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Types :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Pull :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Push :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Auto Push :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:

Binja Sync

Ghidra

Operations     Function Headers     Stack Vars     Global Vars     Structs     Enums     Comments    
Symbols :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Types :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Pull :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Push :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :x:
Auto Push :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :x:

Ghidra Sync

angr-management

Operations     Function Headers     Stack Vars     Global Vars     Structs     Enums     Comments    
Symbols :white_check_mark: :white_check_mark: :x: :x: :x: :white_check_mark:
Types :white_check_mark: :white_check_mark: :x: :x: :x: :white_check_mark:
Pull :white_check_mark: :white_check_mark: :x: :x: :x: :white_check_mark:
Push :white_check_mark: :white_check_mark: :x: :x: :x: :white_check_mark:
Auto Push :white_check_mark: :white_check_mark: :x: :x: :x: :white_check_mark:

Scripting

For scripting please see DecLib, which allows you to do all lifting and data manipulation in Python.

Sponsors

BinSync and its associated projects would not be possible without sponsorship. In no particular order, we'd like to thank all the organizations that have previously or are currently sponsoring one of the many BinSync projects.

NSF
DARPA
ARPA-H
RevEng AI

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for mahaloz from gravatar.com mahaloz

License

BSD License (BSD 2 Clause)

Requires

Python >=3.10

Provides Extra

test extras

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

binsync-5.15.3.tar.gz (155.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

binsync-5.15.3-py3-none-any.whl (164.7 kB view details)

Uploaded Python 3

File details

Details for the file binsync-5.15.3.tar.gz.

File metadata

  • Download URL: binsync-5.15.3.tar.gz
  • Upload date:
  • Size: 155.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for binsync-5.15.3.tar.gz
Algorithm Hash digest
SHA256 b271b21198adbe5bcc7e5b4dbc10fdef0adb2857d47bff8c1d01f1831eb281f8
MD5 ebbba9658f15ff9506da6090f83d1c3b
BLAKE2b-256 1613ca0e6dae6c8ea3c09c380dde4e04f827619b8781c00a8cb267f3995e49c7

See more details on using hashes here.

File details

Details for the file binsync-5.15.3-py3-none-any.whl.

File metadata

  • Download URL: binsync-5.15.3-py3-none-any.whl
  • Upload date:
  • Size: 164.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for binsync-5.15.3-py3-none-any.whl
Algorithm Hash digest
SHA256 da74ef73c023633fcf0d0063087868b7f82c778cb0b840e3623e26aef5f45bac
MD5 13b8c24434032610b54d672f0bb8e10d
BLAKE2b-256 f30e382037daf8997cd65dfb2444c696e10e92da070446041a5fedc9f90b30d7

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

5.15.3

5.15.2

5.15.1

5.15.0

5.14.1

5.14.0

5.13.1

5.13.0

5.12.0

5.11.2

5.11.1

5.11.0

5.10.1

5.10.0

5.9.1

5.9.0

5.8.0

5.7.11

5.7.10

5.7.9

5.7.8

5.7.7

5.7.6

5.7.5

5.7.4

5.7.3

5.7.2

5.7.1

5.7.0

5.6.1

5.6.0

5.5.1

5.5.0

5.4.4

5.4.3

5.4.2

5.4.1

5.3.1

5.3.0

5.2.2

5.2.1

5.2.0

5.1.0

5.0.0

4.10.0

4.9.1

4.9.0

4.8.3

4.8.2

4.8.1

4.8.0

4.7.0

4.6.1

4.6.0

4.5.0

4.4.5

4.4.4

4.4.3

4.4.2

4.4.1

4.3.4

4.3.3

4.3.2

4.3.1

4.3.0

4.2.2

4.2.1

4.2.0

4.1.12

4.1.11

4.1.10

4.1.9

4.1.8

4.1.7

4.1.6

4.1.5

4.1.4

4.1.3

4.1.2

4.1.1

4.1.0

4.0.5

4.0.4

4.0.3

4.0.2

4.0.1

4.0.0

3.26.2

3.26.1

3.26.0

3.25.1

3.23.0

3.22.0

3.21.2

3.20.0

3.19.3

3.19.2

3.19.1

3.19.0

3.18.0

3.16.0

3.15.1

3.15.0

3.13.2

3.13.1

3.13.0

3.11.1

3.11.0

3.10.13

3.10.12

3.10.11

3.10.8

3.10.7

3.10.6

3.10.5

3.10.3

3.10.2

3.10.1

3.9.0

3.6.0

3.5.12

3.5.11

3.5.10

3.5.9

3.5.8

3.5.7

3.5.6

3.5.5

3.5.4

3.5.3

3.5.2

3.4.2

3.4.1

3.3.1

3.3.0

3.2.3

3.2.2

3.1.2

3.1.0

2.10.2

2.10.0

2.9.8

2.9.7

2.9.6

2.9.5

2.9.4

2.9.1

2.9.0

2.8.0

2.7.2

2.7.1

2.7.0

2.4.1

2.4.0

2.3.1

2.3.0

2.2.0

2.1.0

1.0.0

0.0.0.1

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page