# freddyshoesvirtual/kali-nethunter-app architecture

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

- Interactive diagram: https://gitdiagram.com/freddyshoesvirtual/kali-nethunter-app
- Repository: https://github.com/freddyshoesvirtual/kali-nethunter-app

## Overview

NetHunter is an Android installer, updater, and control interface for a Kali Linux chroot. Users enter through the app’s navigation activity, then use feature screens to manage the chroot and its services or access security and device tools. The sampled code shows chroot management, service persistence, privileged shell execution, terminal bridging, audio playback, and GPS publishing. Other documented or tree-visible feature screens are included, but their internal wiring is not inferred where source excerpts do not show it.

Main entry points: [`src/com/offsec/nethunter/RecyclerViewData/KaliServicesData.java`](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/RecyclerViewData/KaliServicesData.java) (Service state and actions), [`src/com/offsec/nethunter/ChrootManagerFragment.java`](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/ChrootManagerFragment.java) (Chroot manager), [`src/com/offsec/nethunter/service/CompatCheckService.java`](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/service/CompatCheckService.java) (Compatibility checks), [`src/com/offsec/nethunter/gps/LocationUpdateService.java`](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/gps/LocationUpdateService.java) (Location publisher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and Chroot"]
  node_navigation["App navigation"]
  node_chroot["Chroot manager"]
  node_compat["Compatibility checks"]
  node_services["Kali services"]
  node_service_data["Service state and actions"]
  node_service_db[("Service database")]
  node_notification["Notifications"]
end

subgraph group_runtime["Execution Runtime"]
  node_paths["Runtime paths<br/>[NhPaths.java]"]
  node_shell["Root shell execution<br/>[ShellExecuter.java]"]
  node_bridge["Terminal bridge<br/>[Bridge.java]"]
  node_terminal["Terminal sessions"]
  node_service_executor["Service executor"]
end

subgraph group_features["Security Features"]
  node_nmap["Nmap tools<br/>[NmapFragment.java]"]
  node_searchsploit["SearchSploit"]
  node_usb["USB Arsenal"]
  node_duckhunter["DuckHunter"]
  node_carsenal["CARsenal"]
  node_evil_twin["Evil Twin"]
  node_nfc["NFC tools<br/>[NFCFragment.java]"]
end

subgraph group_device["Device Services"]
  node_audio["Audio playback<br/>[AudioFragment.java]"]
  node_audio_service["Playback service"]
  node_gps_ui["GPS controls"]
  node_gps_service["Location publisher"]
end

node_user(("Android user"))
node_neo["NeoTerm app"]

node_user -->|"opens app"| node_navigation
node_chroot -->|"runs chroot task"| node_service_executor
node_chroot -->|"starts notification"| node_notification
node_compat -->|"checks chroot"| node_shell
node_compat -->|"resolves paths"| node_paths
node_services -->|"manages service data"| node_service_data
node_service_data -->|"dispatches actions"| node_service_executor
node_service_data -->|"backs up data"| node_service_db
node_audio -->|"uses playback"| node_audio_service
node_gps_ui -->|"controls publisher"| node_gps_service
node_gps_service -->|"publishes location"| node_user
node_bridge -->|"targets remote interface"| node_neo

click node_navigation "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/AppNavHomeActivity.java"
click node_chroot "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/ChrootManagerFragment.java"
click node_compat "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/service/CompatCheckService.java"
click node_paths "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/utils/NhPaths.java"
click node_shell "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/utils/ShellExecuter.java"
click node_bridge "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/bridge/Bridge.java"
click node_terminal "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/service/TerminalService.java"
click node_services "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/KaliServicesFragment.java"
click node_service_data "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/RecyclerViewData/KaliServicesData.java"
click node_service_executor "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/Executor/KaliServicesExecutor.java"
click node_service_db "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/SQL/KaliServicesSQL.java"
click node_audio "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/AudioFragment.java"
click node_audio_service "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/audio/AudioPlaybackService.java"
click node_gps_ui "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/KaliGpsServiceFragment.java"
click node_gps_service "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/gps/LocationUpdateService.java"
click node_nmap "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/NmapFragment.java"
click node_searchsploit "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/SearchSploitFragment.java"
click node_usb "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/USBArsenalFragment.java"
click node_duckhunter "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/DuckHunterFragment.java"
click node_carsenal "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/CARsenalFragment.java"
click node_evil_twin "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/EvilTwinFragment.java"
click node_nfc "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/NFCFragment.java"
click node_notification "https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/service/NotificationChannelService.java"

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_navigation,node_chroot,node_compat,node_services,node_service_data,node_service_db,node_notification,node_user toneBlue
class node_paths,node_shell,node_bridge,node_terminal,node_service_executor toneAmber
class node_nmap,node_searchsploit,node_usb,node_duckhunter,node_carsenal,node_evil_twin,node_nfc toneMint
class node_audio,node_audio_service,node_gps_ui,node_gps_service toneRose
class node_neo toneIndigo
```

## Components

### App and Chroot

- [App navigation](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/AppNavHomeActivity.java): `src/com/offsec/nethunter/AppNavHomeActivity.java`
- [Chroot manager](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/ChrootManagerFragment.java): `src/com/offsec/nethunter/ChrootManagerFragment.java`
- [Compatibility checks](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/service/CompatCheckService.java): `src/com/offsec/nethunter/service/CompatCheckService.java`
- [Kali services](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/KaliServicesFragment.java): `src/com/offsec/nethunter/KaliServicesFragment.java`
- [Service state and actions](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/RecyclerViewData/KaliServicesData.java): `src/com/offsec/nethunter/RecyclerViewData/KaliServicesData.java`
- [Service database](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/SQL/KaliServicesSQL.java): `src/com/offsec/nethunter/SQL/KaliServicesSQL.java`
- [Notifications](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/service/NotificationChannelService.java): `src/com/offsec/nethunter/service/NotificationChannelService.java`

### Execution Runtime

- [Runtime paths](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/utils/NhPaths.java): `src/com/offsec/nethunter/utils/NhPaths.java`
- [Root shell execution](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/utils/ShellExecuter.java): `src/com/offsec/nethunter/utils/ShellExecuter.java`
- [Terminal bridge](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/bridge/Bridge.java): `src/com/offsec/nethunter/bridge/Bridge.java`
- [Terminal sessions](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/service/TerminalService.java): `src/com/offsec/nethunter/service/TerminalService.java`
- [Service executor](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/Executor/KaliServicesExecutor.java): `src/com/offsec/nethunter/Executor/KaliServicesExecutor.java`

### Security Features

- [Nmap tools](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/NmapFragment.java): `src/com/offsec/nethunter/NmapFragment.java`
- [SearchSploit](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/SearchSploitFragment.java): `src/com/offsec/nethunter/SearchSploitFragment.java`
- [USB Arsenal](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/USBArsenalFragment.java): `src/com/offsec/nethunter/USBArsenalFragment.java`
- [DuckHunter](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/DuckHunterFragment.java): `src/com/offsec/nethunter/DuckHunterFragment.java`
- [CARsenal](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/CARsenalFragment.java): `src/com/offsec/nethunter/CARsenalFragment.java`
- [Evil Twin](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/EvilTwinFragment.java): `src/com/offsec/nethunter/EvilTwinFragment.java`
- [NFC tools](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/NFCFragment.java): `src/com/offsec/nethunter/NFCFragment.java`

### Device Services

- [Audio playback](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/AudioFragment.java): `src/com/offsec/nethunter/AudioFragment.java`
- [Playback service](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/audio/AudioPlaybackService.java): `src/com/offsec/nethunter/audio/AudioPlaybackService.java`
- [GPS controls](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/KaliGpsServiceFragment.java): `src/com/offsec/nethunter/KaliGpsServiceFragment.java`
- [Location publisher](https://github.com/freddyshoesvirtual/kali-nethunter-app/blob/main/src/com/offsec/nethunter/gps/LocationUpdateService.java): `src/com/offsec/nethunter/gps/LocationUpdateService.java`

### Other components

- **Android user**
- **NeoTerm app**

## Connections

- Android user → App navigation: opens app
- Chroot manager → Service executor: runs chroot task (evidence: `src/com/offsec/nethunter/ChrootManagerFragment.java`)
- Chroot manager → Notifications: starts notification (evidence: `src/com/offsec/nethunter/ChrootManagerFragment.java`)
- Compatibility checks → Root shell execution: checks chroot (evidence: `src/com/offsec/nethunter/service/CompatCheckService.java`)
- Compatibility checks → Runtime paths: resolves paths (evidence: `src/com/offsec/nethunter/service/CompatCheckService.java`)
- Kali services → Service state and actions: manages service data (evidence: `src/com/offsec/nethunter/KaliServicesFragment.java`)
- Service state and actions → Service executor: dispatches actions (evidence: `src/com/offsec/nethunter/RecyclerViewData/KaliServicesData.java`)
- Service state and actions → Service database: backs up data (evidence: `src/com/offsec/nethunter/RecyclerViewData/KaliServicesData.java`)
- Audio playback → Playback service: uses playback (evidence: `src/com/offsec/nethunter/AudioFragment.java`)
- GPS controls → Location publisher: controls publisher (evidence: `src/com/offsec/nethunter/KaliGpsServiceFragment.java`)
- Location publisher → Android user: publishes location (evidence: `src/com/offsec/nethunter/gps/LocationUpdateService.java`)
- Terminal bridge → NeoTerm app: targets remote interface (evidence: `src/com/offsec/nethunter/bridge/Bridge.java`)
