{"id":13419837,"url":"https://github.com/zyantific/zydis","last_synced_at":"2025-05-13T15:13:18.609Z","repository":{"id":37732983,"uuid":"25708163","full_name":"zyantific/zydis","owner":"zyantific","description":"Fast and lightweight x86/x86-64 disassembler and code generation library","archived":false,"fork":false,"pushed_at":"2025-05-06T12:18:33.000Z","size":17946,"stargazers_count":3689,"open_issues_count":64,"forks_count":445,"subscribers_count":121,"default_branch":"master","last_synced_at":"2025-05-06T13:29:49.697Z","etag":null,"topics":["amd","c","codegen","disassembler","intel","x86","x86-64"],"latest_commit_sha":null,"homepage":"https://zydis.re","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zyantific.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"flobernd"}},"created_at":"2014-10-24T21:05:43.000Z","updated_at":"2025-05-06T12:18:37.000Z","dependencies_parsed_at":"2023-10-15T18:12:33.503Z","dependency_job_id":"431083f1-ec4b-4f33-9ea1-627140b69273","html_url":"https://github.com/zyantific/zydis","commit_stats":null,"previous_names":["zyantific/zyan-disassembler-engine"],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zyantific%2Fzydis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zyantific%2Fzydis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zyantific%2Fzydis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zyantific%2Fzydis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zyantific","download_url":"https://codeload.github.com/zyantific/zydis/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253969266,"owners_count":21992264,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amd","c","codegen","disassembler","intel","x86","x86-64"],"created_at":"2024-07-30T22:01:21.666Z","updated_at":"2025-05-13T15:13:13.599Z","avatar_url":"https://github.com/zyantific.png","language":"C","funding_links":["https://github.com/sponsors/flobernd"],"categories":["TODO scan for Android support in followings","C","c","Disassemblers","\u003ca id=\"2df6d3d07e56381e1101097d013746a0\"\u003e\u003c/a\u003eDisassemble\u0026\u0026反汇编"],"sub_categories":["\u003ca id=\"59f472c7575951c57d298aef21e7d73c\"\u003e\u003c/a\u003e工具"],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://zydis.re/\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/zyantific/zydis/master/assets/img/logo-dark.svg\" width=\"400px\"\u003e\n      \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://raw.githubusercontent.com/zyantific/zydis/master/assets/img/logo-light.svg\" width=\"400px\"\u003e\n      \u003cimg alt=\"zydis logo\" src=\"https://raw.githubusercontent.com/zyantific/zydis/master/assets/img/logo-dark.svg\" width=\"400px\"\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/License-MIT-blue.svg\" alt=\"License: MIT\"\u003e\n  \u003ca href=\"https://github.com/zyantific/zydis/actions\"\u003e\u003cimg src=\"https://github.com/zyantific/zydis/workflows/CI/badge.svg\" alt=\"GitHub Actions\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened\u0026can=1\u0026q=proj:zydis\"\u003e\u003cimg src=\"https://oss-fuzz-build-logs.storage.googleapis.com/badges/zydis.svg\" alt=\"Fuzzing Status\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://discord.zyantific.com/\"\u003e\u003cimg src=\"https://img.shields.io/discord/390136917779415060.svg?logo=discord\u0026label=Discord\" alt=\"Discord\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003eFast and lightweight x86/x86-64 disassembler and code generation library.\u003c/p\u003e\n\n## Features\n\n- Supports all x86 and x86-64 (AMD64) instructions and [extensions](./include/Zydis/Generated/EnumISAExt.h)\n- Optimized for high performance\n- No dynamic memory allocation (\"malloc\")\n- Thread-safe by design\n- Very small file-size overhead compared to other common disassembler libraries\n- [Complete doxygen documentation](https://doc.zydis.re/)\n- Trusted by many major open-source projects\n  - Examples include [x64dbg][zydis-x64dbg], [Mozilla Firefox][zydis-firefox] and [Webkit][zydis-webkit]\n- Absolutely no third party dependencies — not even libc\n  - Should compile on any platform with a working C11 compiler\n  - Tested on Windows, macOS, FreeBSD, Linux and UEFI, both user and kernel mode\n\n[zydis-x64dbg]: https://github.com/x64dbg/x64dbg/tree/729285ef82580812edf7167c41aa6a2c23d8d72d/src/zydis_wrapper\n[zydis-firefox]: https://github.com/mozilla/gecko-dev/tree/3ddbce3c426a55080bd84974444f9ac4869e580b/js/src/zydis\n[zydis-webkit]: https://github.com/WebKit/WebKit/tree/1f2d2a92eeb831bedd01bbb5b694a0e29fa9af81/Source/JavaScriptCore/disassembler/zydis\n\n## Examples\n\n### Disassembler\n\nThe following example program uses Zydis to disassemble a given memory buffer and prints the output to the console.\n\nhttps://github.com/zyantific/zydis/blob/214536a814ba20d2e33d2a907198d1a329aac45c/examples/DisassembleSimple.c#L38-L63\n\nThe above example program generates the following output:\n\n```asm\n007FFFFFFF400000   push rcx\n007FFFFFFF400001   lea eax, [rbp-0x01]\n007FFFFFFF400004   push rax\n007FFFFFFF400005   push qword ptr [rbp+0x0C]\n007FFFFFFF400008   push qword ptr [rbp+0x08]\n007FFFFFFF40000B   call [0x008000007588A5B1]\n007FFFFFFF400011   test eax, eax\n007FFFFFFF400013   js 0x007FFFFFFF42DB15\n```\n\n### Encoder\n\nhttps://github.com/zyantific/zydis/blob/b37076e69f5aa149fde540cae43c50f15a380dfc/examples/EncodeMov.c#L39-L62\n\nThe above example program generates the following output:\n\n```\n48 C7 C0 37 13 00 00\n```\n\n### More Examples\n\nMore examples can be found in the [examples](./examples/) directory of this repository.\n\n## Build\n\nThere are many ways to make Zydis available on your system. The following sub-sections list commonly used options.\n\n### CMake Build\n\n**Platforms:** Windows, macOS, Linux, BSDs\n\nYou can use CMake to build Zydis on all supported platforms. \nInstructions on how to install CMake can be found [here](https://cmake.org/install/).\n\n```bash\ngit clone --recursive 'https://github.com/zyantific/zydis.git'\ncd zydis\ncmake -B build\ncmake --build build -j4\n```\n\n### Visual Studio 2022 project\n\n**Platforms:** Windows\n\nWe manually maintain a [Visual Studio 2022 project](./msvc/) in addition to the CMake build logic.\n\n### CMake generated VS project\n\n**Platforms:** Windows\n\nCMake can be instructed to generate a Visual Studio project for pretty much any VS version. A video guide describing how to use the CMake GUI to generate such project files is available [here](https://www.youtube.com/watch?v=fywLDK1OAtQ). Don't be confused by the apparent use of macOS in the video: Windows is simply running in a virtual machine.\n\n### Amalgamated distribution\n\n**Platforms:** any platform with a working C11 compiler\n\nWe provide an auto-generated single header \u0026 single source file variant of Zydis. To use this variant\nof Zydis in your project, all you need to do is to copy these two files into your project. The \namalgamated builds can be found on our [release page](https://github.com/zyantific/zydis/releases)\nas `zydis-amalgamated.tar.gz`.\n\nThese files are generated with the [`amalgamate.py`](./assets/amalgamate.py) script.\n\n### Package managers\n\n**Platforms:** Windows, macOS, Linux, FreeBSD\n\nPre-built headers, shared libraries and executables are available through a variety of package managers.\n\n\u003cdetails\u003e\n  \u003csummary\u003eZydis version in various package repositories\u003c/summary\u003e\n  \n  [![Packaging status](https://repology.org/badge/vertical-allrepos/zydis.svg)](https://repology.org/project/zydis/versions)\n  \n\u003c/details\u003e\n\n| Repository | Install command                            | \n|------------|--------------------------------------------|\n| Arch Linux | `pacman -S zydis`                          |\n| Debian     | `apt-get install libzydis-dev zydis-tools` |\n| Homebrew   | `brew install zydis`                       |\n| NixOS      | `nix-shell -p zydis`                       |\n| Ubuntu     | `apt-get install libzydis-dev zydis-tools` |\n| vcpkg      | `vcpkg install zydis`                      |\n\n## Using Zydis in a CMake project\n\nAn example on how to use Zydis in your own CMake based project [can be found in this repo](https://github.com/zyantific/zydis-submodule-example).\n\n## `ZydisInfo` tool\n\nThe `ZydisInfo` command-line tool can be used to inspect essentially all information \nthat Zydis provides about an instruction.\n\n![ZydisInfo](./assets/screenshots/ZydisInfo.png)\n\n## Bindings\n\nOfficial bindings exist for a selection of languages:\n\n- [Rust](https://github.com/zyantific/zydis-rs)\n- [Python 3](https://github.com/zyantific/zydis-py)\n\n### asmjit-style C++ front-end\n\nIf you're looking for an asmjit-style assembler front-end for the encoder, check out [zasm](https://github.com/zyantific/zasm).\nzasm also provides an idiomatic C++ wrapper around the decoder and formatter interface.\n\n## Versions\n\n### Scheme\n\nVersions follow the [semantic versioning scheme](https://semver.org/). All stability guarantees apply to the API only. ABI stability is provided only between patch versions.\n\n### Branches \u0026 Tags\n\n- `master` holds the bleeding edge code of the next, unreleased Zydis version. Increased amounts of bugs and issues must be expected and API stability is not guaranteed outside of tagged commits.\n- Stable and preview versions are annotated with git tags\n  - beta and other preview versions have `-beta`, `-rc`, etc. suffixes\n- `maintenance/v4` points to the code of the latest release of v4\n  - v4 is the latest stable major version and receives feature updates\n- `maintenance/v3` points to the code of the latest release of v3\n  - v3 won't get any feature updates but will receive security updates until 2025\n- `maintenance/v2` points to the code of the last legacy release of v2\n  - v2 is has reached end-of-life and won't receive any security updates\n\n## Credits\n\n- Intel (for open-sourcing [XED](https://github.com/intelxed/xed), allowing for automatic comparison of our tables against theirs, improving both)\n- [LLVM](https://llvm.org) (for providing pretty solid instruction data as well)\n- Christian Ludloff (https://sandpile.org, insanely helpful)\n- [LekoArts](https://www.lekoarts.de/) (for creating the project logo)\n- Our [contributors on GitHub](https://github.com/zyantific/zydis/graphs/contributors)\n\n## Troubleshooting\n\n### `-fPIC` for shared library builds\n\n```\n/usr/bin/ld: ./libfoo.a(foo.c.o): relocation R_X86_64_PC32 against symbol `bar' can not be used when making a shared object; recompile with -fPIC\n```\n\nUnder some circumstances (e.g. when building Zydis as a static library using\nCMake and then using Makefiles to manually link it into a shared library), CMake\nmight fail to detect that relocation information must be emitted. This can be forced\nby passing `-DCMAKE_POSITION_INDEPENDENT_CODE=ON` to the CMake invocation.\n\n## Consulting and Business Support\n\nWe offer consulting services and professional business support for Zydis. If you need a custom extension, require help in integrating Zydis into your product or simply want contractually guaranteed updates and turnaround times, we are happy to assist with that! Please contact us at business@zyantific.com.\n\n## Donations\n\nDonations are collected and distributed using [flobernd](https://github.com/users/flobernd/sponsorship)'s account.\n\n## License\n\nZydis is licensed under the MIT license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzyantific%2Fzydis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzyantific%2Fzydis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzyantific%2Fzydis/lists"}