Build and run Ghidra's ARM64 native decompiler on native Termux — without a Linux proot environment.
Ghidra-Termux-ARM64 documents and automates an experimental approach to building Ghidra's native components for ARM64 on native Termux.
It downloads the official Ghidra release from the National Security Agency (NSA), uses Ghidra's supplied Gradle build, and installs the generated native components. This repository contains helper scripts and documentation—not the Ghidra application itself.
Experimental: Tested so far on one rooted Android ARM64 device running native Termux, Ghidra 12.2, OpenJDK 25, and Gradle 9.8. Compatibility with other devices and configurations is not guaranteed.
- Ghidra's headless launcher starts in native Termux.
- ARM64 ELF binaries can be imported and analyzed.
- Native ARM64 decompiler components compile using Ghidra's supplied Gradle build.
- A smoke test successfully generated C-like pseudocode for a function.
- GUI support is untested and unverified. This project focuses on headless workflows.
- Compatibility with other Android devices, Termux versions, Java versions, and Ghidra releases is not guaranteed.
- Decompilation quality varies by binary; warnings and imperfect pseudocode are normal.
- The workflow has not yet been independently audited or validated through a clean-device installation.
- This is a community project and is not affiliated with or endorsed by the NSA or the official Ghidra project.
- Android device using ARM64 / AArch64
- Native Termux environment (not a proot Linux distribution)
- Internet connection and sufficient free storage
- OpenJDK, Clang, Make, Python, Git, Wget, and Unzip (the installer attempts to install these packages)
Review the installer scripts before executing them.
git clone https://github.com/aliasnull/Ghidra-Termux-ARM64.git
cd Ghidra-Termux-ARM64
bash scripts/install.shRun the verification script to test headless analysis and pseudocode generation:
bash scripts/verify.shA successful test prints DECOMPILE_SMOKE_TEST=PASS.
For more details, see the Installation Guide.
A prebuilt installation option may be added later. No prebuilt archive is currently published or promised. For now, use Method A.
Before removing an installation, read the Uninstallation Guide. It will explain what the removal script deletes and how to protect existing files.
- Install the required Termux packages.
- Install a compatible OpenJDK version.
- Download the official Ghidra release.
- Run Ghidra's
support/gradle/gradlew buildNativestask. - Copy the generated ARM64 native outputs into their corresponding runtime directories.
- Run
support/analyzeHeadlessand verify pseudocode generation.
See the Building Guide for details.
Encountering an error? Start with the Troubleshooting Guide. When reporting an issue, include your Android version, Termux version, architecture, Java version, Ghidra version, and the relevant error output.
- Ghidra is downloaded from the official
NationalSecurityAgency/ghidraGitHub releases. - Review scripts before running them; do not run them with root privileges unless explicitly required.
- The project does not intentionally collect credentials or telemetry.
- SHA-256 checksums should accompany project-built release archives. Do not treat an unverified checksum as official.
For reporting security concerns, see SECURITY.md.
The helper scripts and documentation in this repository are licensed under Apache-2.0. Ghidra is a separate upstream project and remains subject to its own license and notices. This repository does not relicense Ghidra.
Built for the Termux community · Experimental · Community-maintained