# proxidize/proxidize-android architecture

> Architecture diagram of the GitHub repository proxidize/proxidize-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/proxidize/proxidize-android
- Repository: https://github.com/proxidize/proxidize-android

## Overview

This archived Android app configures and starts a self-hosted mobile proxy: the user opens the app, optionally sets a tunneling server, connects, and receives endpoint credentials. The README documents local HTTP(S)/SOCKS endpoints, manual and automatic IP rotation, and a rotation link/API. Source excerpts show activity navigation, server preferences, generated connection configuration, the connlib invocation, and foreground-service status. Rotation internals and the server-side implementation were not sampled, so those documented capabilities are represented without inferred implementation links.

Main entry points: [`app/src/main/java/com/legacy/android/LoginActivity.kt`](https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/LoginActivity.kt) (Connection screen), [`app/src/main/java/com/legacy/android/ServerPreference.kt`](https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/ServerPreference.kt) (Server preferences), [`app/src/main/java/com/legacy/android/MainActivity.kt`](https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/MainActivity.kt) (App launch), [`app/src/main/java/com/legacy/android/CustomServerActivity.kt`](https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/CustomServerActivity.kt) (Custom server UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Android app"]
  node_launch["App launch<br/>[MainActivity.kt]"]
  node_connect["Connection screen<br/>[LoginActivity.kt]"]
  node_service["Background service"]
end

subgraph group_config["Server configuration"]
  node_custom["Custom server UI"]
  node_prefs[("Server preferences")]
  node_server["Server settings<br/>[ProxyServer.kt]"]
end

subgraph group_connection["Proxy connection"]
  node_configfile["Connection config<br/>[LoginActivity.kt]"]
  node_tunnel["Tunneling client"]
  node_tunnelserver["Tunneling server"]
  node_localproxy["Local proxy<br/>[LoginActivity.kt]"]
  node_credentials["Proxy credentials<br/>[LoginActivity.kt]"]
end

subgraph group_rotation["Rotation controls"]
  node_rotation["IP rotation<br/>[LoginActivity.kt]"]
  node_rotationapi["Rotation link/API<br/>[LoginActivity.kt]"]
end

node_user(("Device user"))
node_proxyclient(("Proxy client"))

node_user -->|"opens"| node_launch
node_launch -->|"launches"| node_connect
node_user -->|"configures connection"| node_connect
node_connect -->|"opens settings"| node_custom
node_custom -->|"saves or clears"| node_prefs
node_prefs -->|"stores settings"| node_server
node_connect -->|"reads settings"| node_prefs
node_connect -->|"writes"| node_configfile
node_connect -->|"starts client"| node_tunnel
node_tunnel -.->|"connects through"| node_tunnelserver
node_connect -->|"starts proxy"| node_localproxy
node_localproxy -.->|"serves endpoint"| node_proxyclient
node_connect -->|"displays details"| node_credentials
node_connect -->|"starts service"| node_service
node_user -.->|"requests rotation"| node_rotation
node_rotationapi -.->|"triggers rotation"| node_rotation

click node_launch "https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/MainActivity.kt"
click node_connect "https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/LoginActivity.kt"
click node_custom "https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/CustomServerActivity.kt"
click node_prefs "https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/ServerPreference.kt"
click node_server "https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/ProxyServer.kt"
click node_configfile "https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/LoginActivity.kt"
click node_tunnel "https://github.com/proxidize/proxidize-android/blob/main/app/libs/connlib-sources.jar"
click node_tunnelserver "https://github.com/proxidize/proxidize-android/blob/main/server/server"
click node_localproxy "https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/LoginActivity.kt"
click node_credentials "https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/LoginActivity.kt"
click node_service "https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/NotificationService.kt"
click node_rotation "https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/LoginActivity.kt"
click node_rotationapi "https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/LoginActivity.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_launch,node_connect,node_service,node_user,node_proxyclient toneBlue
class node_custom,node_prefs,node_server toneAmber
class node_configfile,node_tunnel,node_tunnelserver,node_localproxy,node_credentials toneMint
class node_rotation,node_rotationapi toneRose
```

## Components

### Android app

- [App launch](https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/MainActivity.kt): `app/src/main/java/com/legacy/android/MainActivity.kt`
- [Connection screen](https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/LoginActivity.kt): `app/src/main/java/com/legacy/android/LoginActivity.kt`
- [Background service](https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/NotificationService.kt): `app/src/main/java/com/legacy/android/NotificationService.kt`

### Server configuration

- [Custom server UI](https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/CustomServerActivity.kt): `app/src/main/java/com/legacy/android/CustomServerActivity.kt`
- [Server preferences](https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/ServerPreference.kt): `app/src/main/java/com/legacy/android/ServerPreference.kt`
- [Server settings](https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/ProxyServer.kt): `app/src/main/java/com/legacy/android/ProxyServer.kt`

### Proxy connection

- [Connection config](https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/LoginActivity.kt): `app/src/main/java/com/legacy/android/LoginActivity.kt`
- [Tunneling client](https://github.com/proxidize/proxidize-android/blob/main/app/libs/connlib-sources.jar): `app/libs/connlib-sources.jar`
- [Tunneling server](https://github.com/proxidize/proxidize-android/blob/main/server/server): `server/server`
- [Local proxy](https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/LoginActivity.kt): `app/src/main/java/com/legacy/android/LoginActivity.kt`
- [Proxy credentials](https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/LoginActivity.kt): `app/src/main/java/com/legacy/android/LoginActivity.kt`

### Rotation controls

- [IP rotation](https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/LoginActivity.kt): `app/src/main/java/com/legacy/android/LoginActivity.kt`
- [Rotation link/API](https://github.com/proxidize/proxidize-android/blob/main/app/src/main/java/com/legacy/android/LoginActivity.kt): `app/src/main/java/com/legacy/android/LoginActivity.kt`

### Other components

- **Device user**
- **Proxy client**

## Connections

- Device user → App launch: opens (evidence: `app/src/main/java/com/legacy/android/MainActivity.kt`)
- App launch → Connection screen: launches (evidence: `app/src/main/java/com/legacy/android/MainActivity.kt`)
- Device user → Connection screen: configures connection (evidence: `app/src/main/java/com/legacy/android/LoginActivity.kt`)
- Connection screen → Custom server UI: opens settings (evidence: `app/src/main/java/com/legacy/android/LoginActivity.kt`)
- Custom server UI → Server preferences: saves or clears (evidence: `app/src/main/java/com/legacy/android/CustomServerActivity.kt`)
- Server preferences → Server settings: stores settings (evidence: `app/src/main/java/com/legacy/android/ServerPreference.kt`)
- Connection screen → Server preferences: reads settings (evidence: `app/src/main/java/com/legacy/android/LoginActivity.kt`)
- Connection screen → Connection config: writes (evidence: `app/src/main/java/com/legacy/android/LoginActivity.kt`)
- Connection screen → Tunneling client: starts client (evidence: `app/src/main/java/com/legacy/android/LoginActivity.kt`)
- Tunneling client → Tunneling server: connects through (evidence: `README.md`)
- Connection screen → Local proxy: starts proxy (evidence: `README.md`)
- Local proxy → Proxy client: serves endpoint (evidence: `README.md`)
- Connection screen → Proxy credentials: displays details (evidence: `app/src/main/java/com/legacy/android/LoginActivity.kt`)
- Connection screen → Background service: starts service (evidence: `app/src/main/java/com/legacy/android/LoginActivity.kt`)
- Device user → IP rotation: requests rotation (evidence: `README.md`)
- Rotation link/API → IP rotation: triggers rotation (evidence: `README.md`)
