# neflalabs/hidethatpeoples architecture

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

- Interactive diagram: https://gitdiagram.com/neflalabs/hidethatpeoples
- Repository: https://github.com/neflalabs/hidethatpeoples

## Overview

HideThatPeoples is an Android privacy and system-management app. Users select messaging/social targets and clear their Direct Share shortcuts through the main screen, Quick Settings tile, or scheduled background work; the privilege manager routes commands through built-in Wireless ADB or root. A separate Debloat workflow manages installed package state. The graph includes documented features whose implementation was not sampled; those relationships are identified by README evidence rather than implying that unsampled code was inspected.

Main entry points: [`app/src/main/java/com/neflalabs/hidethatpeoples/privilege/PrivilegeManager.kt`](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/privilege/PrivilegeManager.kt) (Privilege manager), [`app/src/main/java/com/neflalabs/hidethatpeoples/ui/HomeScreen.kt`](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/ui/HomeScreen.kt) (Home screen), [`app/src/main/java/com/neflalabs/hidethatpeoples/privilege/adb/LocalAdbPrivilegeProvider.kt`](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/privilege/adb/LocalAdbPrivilegeProvider.kt) (Wireless ADB), [`app/src/main/java/com/neflalabs/hidethatpeoples/tile/ClearShortcutsTileService.kt`](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/tile/ClearShortcutsTileService.kt) (Clear shortcuts tile)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_home["Home screen<br/>[HomeScreen.kt]"]
  node_preferences["App preferences<br/>[AppPreferences.kt]"]
end

subgraph group_clean["Shortcut cleaning"]
  node_targets["Target selection"]
  node_tile["Clear shortcuts tile"]
end

subgraph group_privilege["Privilege access"]
  node_privmanager["Privilege manager"]
  node_provider["Provider contract"]
  node_adb["Wireless ADB"]
  node_keys["ADB key management<br/>[AdbKeyManager.kt]"]
  node_mdns["mDNS discovery"]
  node_rootprovider["Root provider"]
end

subgraph group_debloat["Debloat management"]
  node_debloatui["Debloat screen<br/>[DebloatTab.kt]"]
  node_debloatmanager["Package operations<br/>[DebloatManager.kt]"]
  node_debloatapp["Package model<br/>[DebloatApp.kt]"]
  node_presets["Debloat presets<br/>[DebloatPresets.kt]"]
end

subgraph group_support["Background and pairing"]
  node_worker["Auto-clean worker<br/>[AutoCleanWorker.kt]"]
  node_pairingui["Pairing sheet"]
  node_portdialog["Port dialog"]
  node_notification["Pairing notifications"]
  node_pairservice["Pairing service"]
  node_pairreceiver["Pairing receiver"]
  node_updater["App updater"]
end

node_user(("User"))
node_quicksettings(("Quick Settings"))
node_android["Android system"]
node_adbd["Local adbd"]
node_su["Root shell"]

node_user -->|"opens app"| node_activity
node_activity -->|"renders"| node_home
node_home -->|"refreshes access"| node_privmanager
node_home -->|"renders tab"| node_debloatui
node_home -->|"reads settings"| node_preferences
node_home -->|"loads targets"| node_targets
node_home -->|"shows pairing"| node_pairingui
node_home -->|"shows port entry"| node_portdialog
node_home -->|"schedules cleaning"| node_worker
node_home -->|"checks updates"| node_updater
node_preferences -->|"uses defaults"| node_targets
node_user -->|"taps tile"| node_tile
node_quicksettings -.->|"dispatches tap"| node_tile
node_tile -->|"reconnects and clears"| node_privmanager
node_tile -->|"reads targets"| node_preferences
node_tile -->|"opens app"| node_activity
node_worker -->|"reads targets"| node_preferences
node_worker -->|"clears shortcuts"| node_privmanager
node_privmanager -->|"selects provider"| node_preferences
node_privmanager -->|"dispatches commands"| node_adb
node_privmanager -->|"dispatches commands"| node_rootprovider
node_adb -->|"implements"| node_provider
node_rootprovider -->|"implements"| node_provider
node_adb -->|"uses keys"| node_keys
node_adb -->|"discovers ports"| node_mdns
node_adb -->|"prompts pairing"| node_notification
node_adb -->|"connects locally"| node_adbd
node_rootprovider -->|"runs shell"| node_su
node_privmanager -->|"clears shortcuts"| node_android
node_debloatui -->|"requests operations"| node_debloatmanager
node_debloatmanager -.->|"runs package commands"| node_privmanager
node_debloatmanager -->|"uses package model"| node_debloatapp
node_debloatmanager -->|"loads presets"| node_presets
node_debloatui -->|"requests access"| node_privmanager
node_notification -->|"starts service"| node_pairservice
node_pairservice -->|"submits pairing"| node_privmanager
node_pairservice -->|"updates prompt"| node_notification
node_pairreceiver -->|"handles response"| node_privmanager
node_pairreceiver -->|"updates notification"| node_notification
node_android -.->|"runs scheduled work"| node_worker

click node_activity "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/MainActivity.kt"
click node_home "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/ui/HomeScreen.kt"
click node_preferences "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/data/AppPreferences.kt"
click node_targets "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/data/TargetAppManager.kt"
click node_tile "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/tile/ClearShortcutsTileService.kt"
click node_worker "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/worker/AutoCleanWorker.kt"
click node_privmanager "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/privilege/PrivilegeManager.kt"
click node_provider "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/privilege/PrivilegeProvider.kt"
click node_adb "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/privilege/adb/LocalAdbPrivilegeProvider.kt"
click node_keys "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/privilege/adb/crypto/AdbKeyManager.kt"
click node_mdns "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/privilege/adb/mdns/AdbMdnsDiscovery.kt"
click node_rootprovider "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/privilege/root/RootPrivilegeProvider.kt"
click node_debloatui "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/ui/DebloatTab.kt"
click node_debloatmanager "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/data/DebloatManager.kt"
click node_debloatapp "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/data/DebloatApp.kt"
click node_presets "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/data/DebloatPresets.kt"
click node_pairingui "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/ui/components/PairingBottomSheet.kt"
click node_portdialog "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/ui/components/ConnectPortDialog.kt"
click node_notification "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/ui/notification/PairingNotificationHelper.kt"
click node_pairservice "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/ui/notification/PairingForegroundService.kt"
click node_pairreceiver "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/ui/notification/PairingNotificationReceiver.kt"
click node_updater "https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/updater/AppUpdateManager.kt"

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_home,node_preferences,node_user toneBlue
class node_targets,node_tile toneAmber
class node_privmanager,node_provider,node_adb,node_keys,node_mdns,node_rootprovider toneMint
class node_debloatui,node_debloatmanager,node_debloatapp,node_presets toneRose
class node_worker,node_pairingui,node_portdialog,node_notification,node_pairservice,node_pairreceiver,node_updater,node_quicksettings,node_android,node_adbd,node_su toneIndigo
```

## Components

### App experience

- [Main activity](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/MainActivity.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/MainActivity.kt`
- [Home screen](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/ui/HomeScreen.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/ui/HomeScreen.kt`
- [App preferences](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/data/AppPreferences.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/data/AppPreferences.kt`

### Shortcut cleaning

- [Target selection](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/data/TargetAppManager.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/data/TargetAppManager.kt`
- [Clear shortcuts tile](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/tile/ClearShortcutsTileService.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/tile/ClearShortcutsTileService.kt`

### Privilege access

- [Privilege manager](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/privilege/PrivilegeManager.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/privilege/PrivilegeManager.kt`
- [Provider contract](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/privilege/PrivilegeProvider.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/privilege/PrivilegeProvider.kt`
- [Wireless ADB](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/privilege/adb/LocalAdbPrivilegeProvider.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/privilege/adb/LocalAdbPrivilegeProvider.kt`
- [ADB key management](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/privilege/adb/crypto/AdbKeyManager.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/privilege/adb/crypto/AdbKeyManager.kt`
- [mDNS discovery](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/privilege/adb/mdns/AdbMdnsDiscovery.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/privilege/adb/mdns/AdbMdnsDiscovery.kt`
- [Root provider](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/privilege/root/RootPrivilegeProvider.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/privilege/root/RootPrivilegeProvider.kt`

### Debloat management

- [Debloat screen](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/ui/DebloatTab.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/ui/DebloatTab.kt`
- [Package operations](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/data/DebloatManager.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/data/DebloatManager.kt`
- [Package model](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/data/DebloatApp.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/data/DebloatApp.kt`
- [Debloat presets](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/data/DebloatPresets.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/data/DebloatPresets.kt`

### Background and pairing

- [Auto-clean worker](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/worker/AutoCleanWorker.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/worker/AutoCleanWorker.kt`
- [Pairing sheet](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/ui/components/PairingBottomSheet.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/ui/components/PairingBottomSheet.kt`
- [Port dialog](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/ui/components/ConnectPortDialog.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/ui/components/ConnectPortDialog.kt`
- [Pairing notifications](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/ui/notification/PairingNotificationHelper.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/ui/notification/PairingNotificationHelper.kt`
- [Pairing service](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/ui/notification/PairingForegroundService.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/ui/notification/PairingForegroundService.kt`
- [Pairing receiver](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/ui/notification/PairingNotificationReceiver.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/ui/notification/PairingNotificationReceiver.kt`
- [App updater](https://github.com/neflalabs/hidethatpeoples/blob/main/app/src/main/java/com/neflalabs/hidethatpeoples/updater/AppUpdateManager.kt): `app/src/main/java/com/neflalabs/hidethatpeoples/updater/AppUpdateManager.kt`

### Other components

- **User**
- **Quick Settings**
- **Android system**
- **Local adbd**
- **Root shell**

## Connections

- User → Main activity: opens app (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/MainActivity.kt`)
- Main activity → Home screen: renders (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/MainActivity.kt`)
- Home screen → Privilege manager: refreshes access (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/MainActivity.kt`)
- Home screen → Debloat screen: renders tab (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/ui/HomeScreen.kt`)
- Home screen → App preferences: reads settings (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/ui/HomeScreen.kt`)
- Home screen → Target selection: loads targets (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/ui/HomeScreen.kt`)
- Home screen → Pairing sheet: shows pairing (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/ui/HomeScreen.kt`)
- Home screen → Port dialog: shows port entry (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/ui/HomeScreen.kt`)
- Home screen → Auto-clean worker: schedules cleaning (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/ui/HomeScreen.kt`)
- Home screen → App updater: checks updates (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/ui/HomeScreen.kt`)
- App preferences → Target selection: uses defaults (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/data/AppPreferences.kt`)
- User → Clear shortcuts tile: taps tile (evidence: `README.md`)
- Quick Settings → Clear shortcuts tile: dispatches tap
- Clear shortcuts tile → Privilege manager: reconnects and clears (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/tile/ClearShortcutsTileService.kt`)
- Clear shortcuts tile → App preferences: reads targets (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/tile/ClearShortcutsTileService.kt`)
- Clear shortcuts tile → Main activity: opens app (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/tile/ClearShortcutsTileService.kt`)
- Auto-clean worker → App preferences: reads targets (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/worker/AutoCleanWorker.kt`)
- Auto-clean worker → Privilege manager: clears shortcuts (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/worker/AutoCleanWorker.kt`)
- Privilege manager → App preferences: selects provider (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/privilege/PrivilegeManager.kt`)
- Privilege manager → Wireless ADB: dispatches commands (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/privilege/PrivilegeManager.kt`)
- Privilege manager → Root provider: dispatches commands (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/privilege/PrivilegeManager.kt`)
- Wireless ADB → Provider contract: implements (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/privilege/adb/LocalAdbPrivilegeProvider.kt`)
- Root provider → Provider contract: implements (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/privilege/root/RootPrivilegeProvider.kt`)
- Wireless ADB → ADB key management: uses keys (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/privilege/adb/LocalAdbPrivilegeProvider.kt`)
- Wireless ADB → mDNS discovery: discovers ports (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/privilege/adb/LocalAdbPrivilegeProvider.kt`)
- Wireless ADB → Pairing notifications: prompts pairing (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/privilege/adb/LocalAdbPrivilegeProvider.kt`)
- Wireless ADB → Local adbd: connects locally (evidence: `README.md`)
- Root provider → Root shell: runs shell (evidence: `README.md`)
- Privilege manager → Android system: clears shortcuts (evidence: `README.md`)
- Debloat screen → Package operations: requests operations (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/ui/DebloatTab.kt`)
- Package operations → Privilege manager: runs package commands
- Package operations → Package model: uses package model (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/data/DebloatManager.kt`)
- Package operations → Debloat presets: loads presets (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/data/DebloatManager.kt`)
- Debloat screen → Privilege manager: requests access (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/ui/DebloatTab.kt`)
- Pairing notifications → Pairing service: starts service (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/ui/notification/PairingNotificationHelper.kt`)
- Pairing service → Privilege manager: submits pairing (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/ui/notification/PairingForegroundService.kt`)
- Pairing service → Pairing notifications: updates prompt (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/ui/notification/PairingForegroundService.kt`)
- Pairing receiver → Privilege manager: handles response (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/ui/notification/PairingNotificationReceiver.kt`)
- Pairing receiver → Pairing notifications: updates notification (evidence: `app/src/main/java/com/neflalabs/hidethatpeoples/ui/notification/PairingNotificationReceiver.kt`)
- Android system → Auto-clean worker: runs scheduled work
