# credittone/hooker architecture

> Architecture diagram of the GitHub repository credittone/hooker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/credittone/hooker
- Repository: https://github.com/credittone/hooker

## Overview

Hooker is a Frida-based Android reverse-engineering workbench. The main workflow is to choose an app in the CLI, prepare its working directory and scripts, attach or spawn Frida instrumentation, then inspect or export results. Separate capabilities include HTTP exposure, UI/activity exploration, TLS and root-detection hooks, cryptographic/JNI tracing, and proxying. The graph reflects README-documented workflow and sampled source behavior; connections among unsampled modules are omitted where their callers are not evidenced.

Main entry points: [`hooker.py`](https://github.com/credittone/hooker/blob/master/hooker.py) (App Workspace), [`mobile-deploy/redsocks.conf`](https://github.com/credittone/hooker/blob/master/mobile-deploy/redsocks.conf) (SOCKS Proxy), [`js/just_trust_me.js`](https://github.com/credittone/hooker/blob/master/js/just_trust_me.js) (TLS Unpinning), [`js/bypass_root_detect.js`](https://github.com/credittone/hooker/blob/master/js/bypass_root_detect.js) (Root Detection Hooks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workbench["CLI Workbench"]
  node_cli["Hooker CLI<br/>[hooker.py]"]
  node_app_select["App Selection<br/>[hooker.py]"]
  node_workspace["App Workspace<br/>[hooker.py]"]
  node_webserver["Embedded Webserver<br/>[hooker.py]"]
end

subgraph group_instrumentation["Instrumentation"]
  node_frida["Frida Runtime"]
end

subgraph group_analysis["Analysis Scripts"]
  node_tls["TLS Unpinning<br/>[just_trust_me.js]"]
  node_root_bypass["Root Detection Hooks"]
  node_crypto["Crypto Tracing"]
  node_jni["JNI Tracing"]
  node_activity["Activity Exploration<br/>[activity_events.js]"]
  node_rpc["RPC Exploration<br/>[rpc.js]"]
  node_capture["TLS Capture<br/>[r0capture.js]"]
  node_device_info["Device Information<br/>[get_device_info.js]"]
  node_apk_scan["APK Shell Scan"]
  node_dex_dump["DEX Dump<br/>[dump_dex.js]"]
  node_file_dump["Native Library Dump<br/>[dump_so.js]"]
end

subgraph group_device["Device Operations"]
  node_deploy["Device Deployment<br/>[daemon_app.sh]"]
  node_android(("Rooted Android"))
  node_proxy["SOCKS Proxy<br/>[redsocks.conf]"]
end

node_engineer(("Engineer"))

node_engineer -->|"selects app"| node_cli
node_cli -->|"prompts selection"| node_app_select
node_app_select -->|"checks and launches"| node_android
node_app_select -->|"creates workspace"| node_workspace
node_cli -->|"attaches or spawns"| node_frida
node_frida -->|"instruments app"| node_android
node_workspace -->|"provides scripts"| node_tls
node_workspace -->|"provides scripts"| node_root_bypass
node_workspace -->|"provides scripts"| node_crypto
node_workspace -->|"provides scripts"| node_jni
node_workspace -->|"provides scripts"| node_activity
node_workspace -->|"provides scripts"| node_rpc
node_workspace -->|"provides scripts"| node_capture
node_workspace -->|"provides scripts"| node_device_info
node_workspace -->|"provides scripts"| node_apk_scan
node_workspace -->|"provides scripts"| node_dex_dump
node_workspace -->|"provides scripts"| node_file_dump
node_cli -->|"exposes capabilities"| node_webserver
node_webserver -->|"serves app APIs"| node_android
node_cli -->|"manages runtime"| node_deploy
node_cli -->|"configures proxy"| node_proxy
node_proxy -->|"routes traffic"| node_android

click node_cli "https://github.com/credittone/hooker/blob/master/hooker.py"
click node_app_select "https://github.com/credittone/hooker/blob/master/hooker.py"
click node_workspace "https://github.com/credittone/hooker/blob/master/hooker.py"
click node_webserver "https://github.com/credittone/hooker/blob/master/hooker.py"
click node_deploy "https://github.com/credittone/hooker/blob/master/mobile-deploy/daemon_app.sh"
click node_tls "https://github.com/credittone/hooker/blob/master/js/just_trust_me.js"
click node_root_bypass "https://github.com/credittone/hooker/blob/master/js/bypass_root_detect.js"
click node_crypto "https://github.com/credittone/hooker/blob/master/js/hook_encryption_algo.js"
click node_jni "https://github.com/credittone/hooker/blob/master/js/jni_method_trace.js"
click node_activity "https://github.com/credittone/hooker/blob/master/js/activity_events.js"
click node_rpc "https://github.com/credittone/hooker/blob/master/js/rpc.js"
click node_capture "https://github.com/credittone/hooker/blob/master/js/r0capture.js"
click node_device_info "https://github.com/credittone/hooker/blob/master/js/get_device_info.js"
click node_proxy "https://github.com/credittone/hooker/blob/master/mobile-deploy/redsocks.conf"
click node_apk_scan "https://github.com/credittone/hooker/blob/master/js/apk_shell_scanner.js"
click node_dex_dump "https://github.com/credittone/hooker/blob/master/js/dump_dex.js"
click node_file_dump "https://github.com/credittone/hooker/blob/master/js/dump_so.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_app_select,node_workspace,node_webserver toneBlue
class node_frida toneAmber
class node_tls,node_root_bypass,node_crypto,node_jni,node_activity,node_rpc,node_capture,node_device_info,node_apk_scan,node_dex_dump,node_file_dump toneMint
class node_deploy,node_android,node_proxy toneRose
class node_engineer toneIndigo
```

## Components

### CLI Workbench

- [Hooker CLI](https://github.com/credittone/hooker/blob/master/hooker.py): `hooker.py`
- [App Selection](https://github.com/credittone/hooker/blob/master/hooker.py): `hooker.py`
- [App Workspace](https://github.com/credittone/hooker/blob/master/hooker.py): `hooker.py`
- [Embedded Webserver](https://github.com/credittone/hooker/blob/master/hooker.py): `hooker.py`

### Instrumentation

- **Frida Runtime**

### Analysis Scripts

- [TLS Unpinning](https://github.com/credittone/hooker/blob/master/js/just_trust_me.js): `js/just_trust_me.js`
- [Root Detection Hooks](https://github.com/credittone/hooker/blob/master/js/bypass_root_detect.js): `js/bypass_root_detect.js`
- [Crypto Tracing](https://github.com/credittone/hooker/blob/master/js/hook_encryption_algo.js): `js/hook_encryption_algo.js`
- [JNI Tracing](https://github.com/credittone/hooker/blob/master/js/jni_method_trace.js): `js/jni_method_trace.js`
- [Activity Exploration](https://github.com/credittone/hooker/blob/master/js/activity_events.js): `js/activity_events.js`
- [RPC Exploration](https://github.com/credittone/hooker/blob/master/js/rpc.js): `js/rpc.js`
- [TLS Capture](https://github.com/credittone/hooker/blob/master/js/r0capture.js): `js/r0capture.js`
- [Device Information](https://github.com/credittone/hooker/blob/master/js/get_device_info.js): `js/get_device_info.js`
- [APK Shell Scan](https://github.com/credittone/hooker/blob/master/js/apk_shell_scanner.js): `js/apk_shell_scanner.js`
- [DEX Dump](https://github.com/credittone/hooker/blob/master/js/dump_dex.js): `js/dump_dex.js`
- [Native Library Dump](https://github.com/credittone/hooker/blob/master/js/dump_so.js): `js/dump_so.js`

### Device Operations

- [Device Deployment](https://github.com/credittone/hooker/blob/master/mobile-deploy/daemon_app.sh): `mobile-deploy/daemon_app.sh`
- **Rooted Android**
- [SOCKS Proxy](https://github.com/credittone/hooker/blob/master/mobile-deploy/redsocks.conf): `mobile-deploy/redsocks.conf`

### Other components

- **Engineer**

## Connections

- Engineer → Hooker CLI: selects app (evidence: `README.md`)
- Hooker CLI → App Selection: prompts selection (evidence: `README.md`)
- App Selection → Rooted Android: checks and launches (evidence: `README.md`)
- App Selection → App Workspace: creates workspace (evidence: `README.md`)
- Hooker CLI → Frida Runtime: attaches or spawns (evidence: `README.md`)
- Frida Runtime → Rooted Android: instruments app (evidence: `README.md`)
- App Workspace → TLS Unpinning: provides scripts (evidence: `README.md`)
- App Workspace → Root Detection Hooks: provides scripts (evidence: `README.md`)
- App Workspace → Crypto Tracing: provides scripts (evidence: `README.md`)
- App Workspace → JNI Tracing: provides scripts (evidence: `README.md`)
- App Workspace → Activity Exploration: provides scripts (evidence: `README.md`)
- App Workspace → RPC Exploration: provides scripts (evidence: `README.md`)
- App Workspace → TLS Capture: provides scripts (evidence: `README.md`)
- App Workspace → Device Information: provides scripts (evidence: `README.md`)
- App Workspace → APK Shell Scan: provides scripts (evidence: `README.md`)
- App Workspace → DEX Dump: provides scripts (evidence: `README.md`)
- App Workspace → Native Library Dump: provides scripts (evidence: `README.md`)
- Hooker CLI → Embedded Webserver: exposes capabilities (evidence: `README.md`)
- Embedded Webserver → Rooted Android: serves app APIs (evidence: `README.md`)
- Hooker CLI → Device Deployment: manages runtime (evidence: `README.md`)
- Hooker CLI → SOCKS Proxy: configures proxy (evidence: `README.md`)
- SOCKS Proxy → Rooted Android: routes traffic (evidence: `README.md`)
