# xbox123z/zlib-android architecture

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

- Interactive diagram: https://gitdiagram.com/xbox123z/zlib-android
- Repository: https://github.com/xbox123z/zlib-android

## Overview

Z-Library for Android is a native client for searching, inspecting, downloading, and delivering books. The main user path runs from app navigation through search and book detail to file-link resolution and Android downloads; history can initiate a repeat download. Separate branches cover login, mirror diagnosis, profile/quota, settings and SMTP Kindle delivery. The graph uses excerpted calls and README statements; some screen-to-client relationships are supported by the source index, while unsampled internals and integrations are omitted where ownership is unclear.

Main entry points: [`app/src/main/java/com/xbox123z/zlib/MainActivity.kt`](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/MainActivity.kt) (Navigation shell), [`app/src/main/java/com/xbox123z/zlib/data/ZLibClient.kt`](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/data/ZLibClient.kt) (Z-Library API), [`app/src/main/java/com/xbox123z/zlib/ui/DetailScreen.kt`](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/DetailScreen.kt) (Book details), [`app/src/main/java/com/xbox123z/zlib/ui/HistoryScreen.kt`](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/HistoryScreen.kt) (Download history)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_activity["Navigation shell<br/>[MainActivity.kt]"]
  node_appcore["App services<br/>[ZLibApp.kt]"]
end

subgraph group_catalog["Catalog and account"]
  node_search["Book search<br/>[SearchScreen.kt]"]
  node_detail["Book details<br/>[DetailScreen.kt]"]
  node_login["Account login<br/>[LoginScreen.kt]"]
  node_profile["Profile and quota<br/>[ProfileScreen.kt]"]
  node_history["Download history<br/>[HistoryScreen.kt]"]
  node_doctor["Mirror diagnosis<br/>[DoctorScreen.kt]"]
  node_client["Z-Library API<br/>[ZLibClient.kt]"]
  node_models["Book and API models<br/>[Models.kt]"]
end

subgraph group_delivery["Book delivery"]
  node_downloadscreen["Download manager view<br/>[DownloadsScreen.kt]"]
  node_downloads["System downloads<br/>[Downloads.kt]"]
  node_kindle["Kindle SMTP sender<br/>[KindleSender.kt]"]
end

subgraph group_settings["Preferences"]
  node_prefs[("Persistent preferences<br/>[Prefs.kt]")]
  node_settingsui["Settings<br/>[SettingsScreen.kt]"]
  node_theme["Theme<br/>[Theme.kt]"]
end

node_user(("Reader"))
node_zlib{{"Z-Library service"}}
node_androiddm[("Android DownloadManager")]
node_smtp{{"SMTP server"}}
node_kindledevice(("Kindle inbox"))

node_user -->|"opens"| node_activity
node_activity -->|"routes to"| node_search
node_activity -->|"routes to"| node_detail
node_activity -->|"routes to"| node_doctor
node_activity -->|"routes to"| node_login
node_activity -->|"routes to"| node_profile
node_activity -->|"routes to"| node_history
node_activity -->|"routes to"| node_downloadscreen
node_activity -->|"routes to"| node_settingsui
node_appcore -->|"creates"| node_prefs
node_appcore -->|"creates"| node_client
node_appcore -->|"creates"| node_downloads
node_search -->|"searches"| node_client
node_detail -->|"loads details"| node_client
node_detail -->|"resolves file URL"| node_client
node_detail -->|"enqueues file"| node_downloads
node_history -->|"loads history"| node_client
node_history -->|"resolves file URL"| node_client
node_history -->|"enqueues repeat"| node_downloads
node_doctor -.->|"probes mirrors"| node_client
node_login -.->|"authenticates"| node_client
node_profile -.->|"loads account data"| node_client
node_settingsui -->|"updates settings"| node_prefs
node_activity -->|"sends message"| node_kindle
node_activity -->|"reads SMTP config"| node_prefs
node_activity -.->|"fetches book file"| node_client
node_downloads -->|"queues and queries"| node_androiddm
node_client -->|"calls API"| node_zlib
node_kindle -->|"delivers via"| node_smtp
node_smtp -.->|"delivers email"| node_kindledevice

click node_activity "https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/MainActivity.kt"
click node_appcore "https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ZLibApp.kt"
click node_search "https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/SearchScreen.kt"
click node_detail "https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/DetailScreen.kt"
click node_login "https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/LoginScreen.kt"
click node_profile "https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/ProfileScreen.kt"
click node_history "https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/HistoryScreen.kt"
click node_doctor "https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/DoctorScreen.kt"
click node_client "https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/data/ZLibClient.kt"
click node_models "https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/data/Models.kt"
click node_prefs "https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/data/Prefs.kt"
click node_settingsui "https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/SettingsScreen.kt"
click node_theme "https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/Theme.kt"
click node_downloadscreen "https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/DownloadsScreen.kt"
click node_downloads "https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/dl/Downloads.kt"
click node_kindle "https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/kindle/KindleSender.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_appcore toneBlue
class node_search,node_detail,node_login,node_profile,node_history,node_doctor,node_client,node_models,node_androiddm toneAmber
class node_downloadscreen,node_downloads,node_kindle,node_smtp toneMint
class node_prefs,node_settingsui,node_theme toneRose
class node_user,node_zlib,node_kindledevice toneIndigo
```

## Components

### App shell

- [Navigation shell](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/MainActivity.kt): `app/src/main/java/com/xbox123z/zlib/MainActivity.kt`
- [App services](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ZLibApp.kt): `app/src/main/java/com/xbox123z/zlib/ZLibApp.kt`

### Catalog and account

- [Book search](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/SearchScreen.kt): `app/src/main/java/com/xbox123z/zlib/ui/SearchScreen.kt`
- [Book details](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/DetailScreen.kt): `app/src/main/java/com/xbox123z/zlib/ui/DetailScreen.kt`
- [Account login](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/LoginScreen.kt): `app/src/main/java/com/xbox123z/zlib/ui/LoginScreen.kt`
- [Profile and quota](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/ProfileScreen.kt): `app/src/main/java/com/xbox123z/zlib/ui/ProfileScreen.kt`
- [Download history](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/HistoryScreen.kt): `app/src/main/java/com/xbox123z/zlib/ui/HistoryScreen.kt`
- [Mirror diagnosis](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/DoctorScreen.kt): `app/src/main/java/com/xbox123z/zlib/ui/DoctorScreen.kt`
- [Z-Library API](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/data/ZLibClient.kt): `app/src/main/java/com/xbox123z/zlib/data/ZLibClient.kt`
- [Book and API models](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/data/Models.kt): `app/src/main/java/com/xbox123z/zlib/data/Models.kt`

### Book delivery

- [Download manager view](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/DownloadsScreen.kt): `app/src/main/java/com/xbox123z/zlib/ui/DownloadsScreen.kt`
- [System downloads](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/dl/Downloads.kt): `app/src/main/java/com/xbox123z/zlib/dl/Downloads.kt`
- [Kindle SMTP sender](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/kindle/KindleSender.kt): `app/src/main/java/com/xbox123z/zlib/kindle/KindleSender.kt`

### Preferences

- [Persistent preferences](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/data/Prefs.kt): `app/src/main/java/com/xbox123z/zlib/data/Prefs.kt`
- [Settings](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/SettingsScreen.kt): `app/src/main/java/com/xbox123z/zlib/ui/SettingsScreen.kt`
- [Theme](https://github.com/xbox123z/zlib-android/blob/main/app/src/main/java/com/xbox123z/zlib/ui/Theme.kt): `app/src/main/java/com/xbox123z/zlib/ui/Theme.kt`

### Other components

- **Reader**
- **Z-Library service**
- **Android DownloadManager**
- **SMTP server**
- **Kindle inbox**

## Connections

- Reader → Navigation shell: opens (evidence: `app/src/main/java/com/xbox123z/zlib/MainActivity.kt`)
- Navigation shell → Book search: routes to (evidence: `app/src/main/java/com/xbox123z/zlib/MainActivity.kt`)
- Navigation shell → Book details: routes to (evidence: `app/src/main/java/com/xbox123z/zlib/MainActivity.kt`)
- Navigation shell → Mirror diagnosis: routes to (evidence: `app/src/main/java/com/xbox123z/zlib/MainActivity.kt`)
- Navigation shell → Account login: routes to (evidence: `app/src/main/java/com/xbox123z/zlib/MainActivity.kt`)
- Navigation shell → Profile and quota: routes to (evidence: `app/src/main/java/com/xbox123z/zlib/MainActivity.kt`)
- Navigation shell → Download history: routes to (evidence: `app/src/main/java/com/xbox123z/zlib/MainActivity.kt`)
- Navigation shell → Download manager view: routes to (evidence: `app/src/main/java/com/xbox123z/zlib/MainActivity.kt`)
- Navigation shell → Settings: routes to (evidence: `app/src/main/java/com/xbox123z/zlib/MainActivity.kt`)
- App services → Persistent preferences: creates (evidence: `app/src/main/java/com/xbox123z/zlib/ZLibApp.kt`)
- App services → Z-Library API: creates (evidence: `app/src/main/java/com/xbox123z/zlib/ZLibApp.kt`)
- App services → System downloads: creates (evidence: `app/src/main/java/com/xbox123z/zlib/ZLibApp.kt`)
- Book search → Z-Library API: searches (evidence: `app/src/main/java/com/xbox123z/zlib/ui/SearchScreen.kt`)
- Book details → Z-Library API: loads details (evidence: `app/src/main/java/com/xbox123z/zlib/ui/DetailScreen.kt`)
- Book details → Z-Library API: resolves file URL (evidence: `app/src/main/java/com/xbox123z/zlib/ui/DetailScreen.kt`)
- Book details → System downloads: enqueues file (evidence: `app/src/main/java/com/xbox123z/zlib/ui/DetailScreen.kt`)
- Download history → Z-Library API: loads history (evidence: `app/src/main/java/com/xbox123z/zlib/ui/HistoryScreen.kt`)
- Download history → Z-Library API: resolves file URL (evidence: `app/src/main/java/com/xbox123z/zlib/ui/HistoryScreen.kt`)
- Download history → System downloads: enqueues repeat (evidence: `app/src/main/java/com/xbox123z/zlib/ui/HistoryScreen.kt`)
- Mirror diagnosis → Z-Library API: probes mirrors
- Account login → Z-Library API: authenticates
- Profile and quota → Z-Library API: loads account data
- Settings → Persistent preferences: updates settings (evidence: `app/src/main/java/com/xbox123z/zlib/ui/SettingsScreen.kt`)
- Navigation shell → Kindle SMTP sender: sends message (evidence: `app/src/main/java/com/xbox123z/zlib/MainActivity.kt`)
- Navigation shell → Persistent preferences: reads SMTP config (evidence: `app/src/main/java/com/xbox123z/zlib/MainActivity.kt`)
- Navigation shell → Z-Library API: fetches book file
- System downloads → Android DownloadManager: queues and queries (evidence: `app/src/main/java/com/xbox123z/zlib/dl/Downloads.kt`)
- Z-Library API → Z-Library service: calls API (evidence: `app/src/main/java/com/xbox123z/zlib/data/ZLibClient.kt`)
- Kindle SMTP sender → SMTP server: delivers via (evidence: `app/src/main/java/com/xbox123z/zlib/kindle/KindleSender.kt`)
- SMTP server → Kindle inbox: delivers email (evidence: `README.md`)
