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
CCreated 2013-11-27www.capstone-engine.org
下载:6.0.0-Alpha116.0.0-Alpha11 ↓112026-09-21
+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

Discussions

Latest release

6.0.0-Alpha11 6.0.0-Alpha11 2026-09-21
Highlights

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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON