capstone-engine /capstone
Capstone disassembly/disassembler framework for ARM, ARM64 (ARMv8), Alpha, BPF, Ethereum VM, HPPA, LoongArch, M68K, M680X, Mips, MOS65XX, PPC, RISC-V(rv32G/rv64G), SH, Sparc, SystemZ, TMS320C64X, TriCore, Webassembly, XCore and X86.
★ 9,195⑂ 1,751👁 283⑃ 1,683● 1,453▤ 49
+5
日增长
9,195
stars
1,751
forks
283
watchers
1,683
prs
1,453
issues
49
releases
README
Capstone Engine =============== [!TIP] Welcome to join our community group!   Capstone is a disassembly framework with the target of becoming the ultimate disasm engine for binary analysis and reversing in the security community. Created by Nguyen Anh Quynh, then developed and maintained by a small community, Capstone offers some unparalleled features: - Support multiple hardware architectures: ARM, AArch64, Alpha, ARC, BPF, Ethereum VM, LoongArch, HP PA-RISC (HPPA), M68K, M680X, Mips, MOS65XX, PPC, RISC-V(rv32G/rv64G), SH, Sparc, SystemZ, TMS320C64X, TriCore, Webassembly, XCore and X86 (16, 32, 64), Xtensa. - Having clean/simple/lightweight/intuitive architecture-neutral API. - Provide details on disassembled instruction (called “decomposer” by others). - Provide semantics of the disassembled instruction, such as list of implicit registers read & written. - Implemented in pure C language, with lightweight bindings for Swift, D, Clojure, F, Common Lisp, Visual Basic, PHP, PowerShell, Emacs, Haskell, Perl, Python, Ruby, C, NodeJS, Java, GO, C++, OCaml, Lua, Rust, Delphi, Free Pascal & Vala ready either in main code, or provided externally by the community). - Native support for all popular platforms: Windows, Mac OSX, iOS, Android, Linux, \BSD, Solaris, etc. - Thread-safe by design. - Special support for embedding into firmware or OS kernel. - High performance & suitable for malware analysis (capable of handling various X86 malware tricks). - Distributed under the open source BSD license. Further information is available at https://www.capstone-engine.org Compile ------- See BUILDING.md file for how to compile and install Capstone. Documentation ------------- - Useful links and tutorials: docs/README - Software architecture overview: docs/ARCHITECTURE.md - Testing documentation: tests/README.md - Updater (Auto-Sync) documentation: suite/auto-sync/README.md Contributing ---- See CONTRIBUTING.md for an intro. Fuzz ---- See suite/fuzz/README.md for more information. License ------- This project is released under the BSD license. If you redistribute the binary or source code of Capstone, please attach file LICENSE.TXT with your products.
Top issues
#2015`auto-sync` progress tracker: Refactor and implement architectures29 comments · 2023-05-09#1781Clarify Capstone branching strategy23 comments · 2021-08-29#2850Proposal: Release a `capstone6` package for the next major version21 comments · 2026-02-02#1129Failure disassembling 'endbr64' (x86 IBT feature)20 comments · 2018-05-07#917REP STOSW instruction is disassembled as REP STOSD in 32-bit mode16 comments · 2017-05-07#1562Empty entries in X86MappingInsnOp.inc will cripple Dyninst (next branch)13 comments · 2019-11-01#17494.0.2 pip install / build fail on FreeBSD12 comments · 2021-05-11#1170error: Unsupported architecture10 comments · 2018-06-08
Discussions
#2637Inconsistent API naming1 comments · 2025-02-26#2505Replace x86 module with Zydis8 comments · 2024-10-10#2289Welcome to capstone Discussions!0 comments · 2024-03-20#2291Update java and ocaml bindings4 comments · 2024-02-28#2290Build system discussion3 comments · 2024-02-03#2293Add more maintainers8 comments · 2023-07-18
Latest release
6.0.0-Alpha11 6.0.0-Alpha11 2026-09-21Highlights This is another patch release with multiple instruction fixes and bug fixes. This release adds an AGENTS.md file and developer AI guidelines. API changes/additions x86: Support alternative disassembly for JO/JNO operands in 64-bit mode. This adds two modes for x86: CS_MODE_X86_AMD and CS_MODE_X86_INTEL. Setting either of these flags will currently only affect the JO/JNO instructions. Please check the release guide for more details. _The default behavior of the x86 module did not change._ Xtensa: Gate ESP32-S3 and HIFI3 instructions behind CS_MODE_XTENSA_E