How sa-fw-an/android-rat works
Android-RAT is a Python CLI for generating Android Meterpreter APKs, modifying and signing them for modern Android compatibility, and starting a Metasploit listener. The main user workflow starts in the menu: payload generation invokes msfvenom and then its manifest patch/align/sign routine; users can also separately patch an APK, sign one, or launch a handler. The README documents compatibility and deployment capabilities, but device installation is not implemented in the shown source. The two patching paths are distinct. Relationships are limited to calls visible in excerpts or capabilities documented in the README.
Main entry points: cli.py Interactive menu · payload_generator.py Payload generation · apk_patch.py Manifest patching · apk_patcher.py Visible UI patching
Components 13
CLI
- Interactive menu
cli.py
APK workflows
- Payload generation
builder/payload_generator.py - Manifest patching
builder/apk_patch.py - Visible UI patching
builder/apk_patcher.py - APK signing
builder/apk_signer.py - Generated APK files
output/README.md
Handler
- Metasploit handler
builder/metasploit_handler.py
Other components
- Operator
- msfvenom
- apktool
- zipalign
- apksigner
- Metasploit Framework
Connections 17
- Operator → Interactive menu: chooses action
cli.py - Interactive menu → Payload generation: calls build
cli.py - Interactive menu → Visible UI patching: calls patch
cli.py - Interactive menu → APK signing: calls signing
cli.py - Interactive menu → Metasploit handler: starts listener
cli.py - Payload generation → msfvenom: runs command
builder/payload_generator.py - Payload generation → Manifest patching: calls patch/sign
builder/payload_generator.py - Manifest patching → apktool: decodes and rebuilds
builder/apk_patch.py - Manifest patching → zipalign: aligns APK
builder/apk_patch.py - Manifest patching → apksigner: signs APK
builder/apk_patch.py - Visible UI patching → apktool: decodes and rebuilds
builder/apk_patcher.py - Visible UI patching → zipalign: aligns APK
builder/apk_patcher.py - Visible UI patching → apksigner: signs APK
builder/apk_patcher.py - APK signing → apksigner: runs signing
builder/apk_signer.py - Payload generation → Generated APK files: writes APK
builder/payload_generator.py - Metasploit handler → Metasploit Framework: runs msfconsole
builder/metasploit_handler.py - Operator → Generated APK files: installs APK
README.md