# muntashirakon/libadb-android architecture

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

- Interactive diagram: https://gitdiagram.com/muntashirakon/libadb-android
- Repository: https://github.com/muntashirakon/libadb-android

## Overview

LibADB Android is a reusable Android ADB client, with a sample app demonstrating discovery, pairing, connection, and shell-command execution. The library separates connection management, transport/protocol handling, stream I/O, pairing, and Android-specific discovery. The graph includes documented capabilities whose implementation was not fully sampled; relationships are limited to README statements and source-index references, with unsampled details left unspecified.

Main entry points: [`libadb/src/main/java/io/github/muntashirakon/adb/AdbConnection.java`](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/AdbConnection.java) (ADB connection), [`libadb/src/main/java/io/github/muntashirakon/adb/AbsAdbConnectionManager.java`](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/AbsAdbConnectionManager.java) (Connection manager), [`libadb/src/main/java/io/github/muntashirakon/adb/PairingConnectionCtx.java`](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/PairingConnectionCtx.java) (Pairing transport), [`libadb/src/main/java/io/github/muntashirakon/adb/AdbStream.java`](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/AdbStream.java) (ADB streams)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sample["Sample app"]
  node_activity["Main activity<br/>[MainActivity.java]"]
  node_viewmodel["ADB controls<br/>[MainViewModel.java]"]
  node_samplemanager["Sample credentials"]
end

subgraph group_connection["Connection management"]
  node_manager["Connection manager"]
  node_mdns["ADB discovery<br/>[AdbMdns.java]"]
  node_androidutils["Android networking<br/>[AndroidUtils.java]"]
end

subgraph group_transport["ADB transport"]
  node_connectioncore["ADB connection<br/>[AdbConnection.java]"]
  node_protocol["Packet protocol<br/>[AdbProtocol.java]"]
  node_stream["ADB streams<br/>[AdbStream.java]"]
  node_input["Input stream"]
  node_output["Output stream"]
  node_services["ADB services<br/>[LocalServices.java]"]
end

subgraph group_security["Authentication and pairing"]
  node_keypair["Key material<br/>[KeyPair.java]"]
  node_pubkey["ADB public key<br/>[AndroidPubkey.java]"]
  node_tls["TLS utilities<br/>[SslUtils.java]"]
  node_pairctx["Pairing transport"]
  node_pairauth["Pairing authentication"]
  node_prng["PRNG compatibility<br/>[PRNGFixes.java]"]
end

node_user(("App user"))
node_adb(("ADB daemon"))

node_user -->|"uses"| node_activity
node_activity -->|"delegates to"| node_viewmodel
node_viewmodel -->|"requests connection"| node_manager
node_viewmodel -->|"opens shell"| node_services
node_samplemanager -->|"provides credentials"| node_manager
node_manager -->|"discovers daemon"| node_mdns
node_mdns -->|"checks address"| node_androidutils
node_manager -->|"creates connection"| node_connectioncore
node_manager -->|"starts pairing"| node_pairctx
node_manager -->|"supplies keys"| node_keypair
node_manager -->|"resolves service"| node_services
node_connectioncore -->|"connects to"| node_adb
node_connectioncore -->|"encodes packets"| node_protocol
node_connectioncore -->|"opens streams"| node_stream
node_connectioncore -->|"creates TLS context"| node_tls
node_connectioncore -->|"uses keys"| node_keypair
node_connectioncore -->|"uses public key"| node_pubkey
node_stream -->|"encodes writes"| node_protocol
node_stream -->|"creates reader"| node_input
node_stream -->|"creates writer"| node_output
node_pairctx -->|"uses authentication"| node_pairauth
node_pairctx -->|"uses keys"| node_keypair
node_pairctx -->|"uses public key"| node_pubkey
node_pairctx -->|"uses TLS"| node_tls
node_pairctx -->|"pairs with"| node_adb
node_prng -.->|"optional compatibility"| node_samplemanager

click node_activity "https://github.com/muntashirakon/libadb-android/blob/master/app/src/main/java/io/github/muntashirakon/adb/testapp/MainActivity.java"
click node_viewmodel "https://github.com/muntashirakon/libadb-android/blob/master/app/src/main/java/io/github/muntashirakon/adb/testapp/MainViewModel.java"
click node_samplemanager "https://github.com/muntashirakon/libadb-android/blob/master/app/src/main/java/io/github/muntashirakon/adb/testapp/AdbConnectionManager.java"
click node_manager "https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/AbsAdbConnectionManager.java"
click node_mdns "https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/android/AdbMdns.java"
click node_androidutils "https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/android/AndroidUtils.java"
click node_connectioncore "https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/AdbConnection.java"
click node_protocol "https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/AdbProtocol.java"
click node_stream "https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/AdbStream.java"
click node_input "https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/AdbInputStream.java"
click node_output "https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/AdbOutputStream.java"
click node_services "https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/LocalServices.java"
click node_keypair "https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/KeyPair.java"
click node_pubkey "https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/AndroidPubkey.java"
click node_tls "https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/SslUtils.java"
click node_pairctx "https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/PairingConnectionCtx.java"
click node_pairauth "https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/PairingAuthCtx.java"
click node_prng "https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/PRNGFixes.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_activity,node_viewmodel,node_samplemanager,node_user toneBlue
class node_manager,node_mdns,node_androidutils toneAmber
class node_connectioncore,node_protocol,node_stream,node_input,node_output,node_services toneMint
class node_keypair,node_pubkey,node_tls,node_pairctx,node_pairauth,node_prng toneRose
class node_adb toneIndigo
```

## Components

### Sample app

- [Main activity](https://github.com/muntashirakon/libadb-android/blob/master/app/src/main/java/io/github/muntashirakon/adb/testapp/MainActivity.java): `app/src/main/java/io/github/muntashirakon/adb/testapp/MainActivity.java`
- [ADB controls](https://github.com/muntashirakon/libadb-android/blob/master/app/src/main/java/io/github/muntashirakon/adb/testapp/MainViewModel.java): `app/src/main/java/io/github/muntashirakon/adb/testapp/MainViewModel.java`
- [Sample credentials](https://github.com/muntashirakon/libadb-android/blob/master/app/src/main/java/io/github/muntashirakon/adb/testapp/AdbConnectionManager.java): `app/src/main/java/io/github/muntashirakon/adb/testapp/AdbConnectionManager.java`

### Connection management

- [Connection manager](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/AbsAdbConnectionManager.java): `libadb/src/main/java/io/github/muntashirakon/adb/AbsAdbConnectionManager.java`
- [ADB discovery](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/android/AdbMdns.java): `libadb/src/main/java/io/github/muntashirakon/adb/android/AdbMdns.java`
- [Android networking](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/android/AndroidUtils.java): `libadb/src/main/java/io/github/muntashirakon/adb/android/AndroidUtils.java`

### ADB transport

- [ADB connection](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/AdbConnection.java): `libadb/src/main/java/io/github/muntashirakon/adb/AdbConnection.java`
- [Packet protocol](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/AdbProtocol.java): `libadb/src/main/java/io/github/muntashirakon/adb/AdbProtocol.java`
- [ADB streams](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/AdbStream.java): `libadb/src/main/java/io/github/muntashirakon/adb/AdbStream.java`
- [Input stream](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/AdbInputStream.java): `libadb/src/main/java/io/github/muntashirakon/adb/AdbInputStream.java`
- [Output stream](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/AdbOutputStream.java): `libadb/src/main/java/io/github/muntashirakon/adb/AdbOutputStream.java`
- [ADB services](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/LocalServices.java): `libadb/src/main/java/io/github/muntashirakon/adb/LocalServices.java`

### Authentication and pairing

- [Key material](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/KeyPair.java): `libadb/src/main/java/io/github/muntashirakon/adb/KeyPair.java`
- [ADB public key](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/AndroidPubkey.java): `libadb/src/main/java/io/github/muntashirakon/adb/AndroidPubkey.java`
- [TLS utilities](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/SslUtils.java): `libadb/src/main/java/io/github/muntashirakon/adb/SslUtils.java`
- [Pairing transport](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/PairingConnectionCtx.java): `libadb/src/main/java/io/github/muntashirakon/adb/PairingConnectionCtx.java`
- [Pairing authentication](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/PairingAuthCtx.java): `libadb/src/main/java/io/github/muntashirakon/adb/PairingAuthCtx.java`
- [PRNG compatibility](https://github.com/muntashirakon/libadb-android/blob/master/libadb/src/main/java/io/github/muntashirakon/adb/PRNGFixes.java): `libadb/src/main/java/io/github/muntashirakon/adb/PRNGFixes.java`

### Other components

- **App user**
- **ADB daemon**

## Connections

- App user → Main activity: uses (evidence: `app/src/main/java/io/github/muntashirakon/adb/testapp/MainActivity.java`)
- Main activity → ADB controls: delegates to (evidence: `app/src/main/java/io/github/muntashirakon/adb/testapp/MainActivity.java`)
- ADB controls → Connection manager: requests connection (evidence: `app/src/main/java/io/github/muntashirakon/adb/testapp/MainViewModel.java`)
- ADB controls → ADB services: opens shell (evidence: `app/src/main/java/io/github/muntashirakon/adb/testapp/MainViewModel.java`)
- Sample credentials → Connection manager: provides credentials (evidence: `app/src/main/java/io/github/muntashirakon/adb/testapp/AdbConnectionManager.java`)
- Connection manager → ADB discovery: discovers daemon (evidence: `libadb/src/main/java/io/github/muntashirakon/adb/AbsAdbConnectionManager.java`)
- ADB discovery → Android networking: checks address (evidence: `libadb/src/main/java/io/github/muntashirakon/adb/android/AdbMdns.java`)
- Connection manager → ADB connection: creates connection (evidence: `libadb/src/main/java/io/github/muntashirakon/adb/AbsAdbConnectionManager.java`)
- Connection manager → Pairing transport: starts pairing (evidence: `libadb/src/main/java/io/github/muntashirakon/adb/AbsAdbConnectionManager.java`)
- Connection manager → Key material: supplies keys (evidence: `libadb/src/main/java/io/github/muntashirakon/adb/AbsAdbConnectionManager.java`)
- Connection manager → ADB services: resolves service (evidence: `libadb/src/main/java/io/github/muntashirakon/adb/AbsAdbConnectionManager.java`)
- ADB connection → ADB daemon: connects to (evidence: `README.md`)
- ADB connection → Packet protocol: encodes packets (evidence: `libadb/src/main/java/io/github/muntashirakon/adb/AdbConnection.java`)
- ADB connection → ADB streams: opens streams (evidence: `libadb/src/main/java/io/github/muntashirakon/adb/AdbConnection.java`)
- ADB connection → TLS utilities: creates TLS context (evidence: `libadb/src/main/java/io/github/muntashirakon/adb/AdbConnection.java`)
- ADB connection → Key material: uses keys (evidence: `libadb/src/main/java/io/github/muntashirakon/adb/AdbConnection.java`)
- ADB connection → ADB public key: uses public key (evidence: `libadb/src/main/java/io/github/muntashirakon/adb/AdbConnection.java`)
- ADB streams → Packet protocol: encodes writes (evidence: `libadb/src/main/java/io/github/muntashirakon/adb/AdbStream.java`)
- ADB streams → Input stream: creates reader (evidence: `libadb/src/main/java/io/github/muntashirakon/adb/AdbStream.java`)
- ADB streams → Output stream: creates writer (evidence: `libadb/src/main/java/io/github/muntashirakon/adb/AdbStream.java`)
- Pairing transport → Pairing authentication: uses authentication (evidence: `libadb/src/main/java/io/github/muntashirakon/adb/PairingConnectionCtx.java`)
- Pairing transport → Key material: uses keys (evidence: `libadb/src/main/java/io/github/muntashirakon/adb/PairingConnectionCtx.java`)
- Pairing transport → ADB public key: uses public key (evidence: `libadb/src/main/java/io/github/muntashirakon/adb/PairingConnectionCtx.java`)
- Pairing transport → TLS utilities: uses TLS (evidence: `libadb/src/main/java/io/github/muntashirakon/adb/PairingConnectionCtx.java`)
- Pairing transport → ADB daemon: pairs with (evidence: `README.md`)
- PRNG compatibility → Sample credentials: optional compatibility
