# matan-h/transfer architecture

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

- Interactive diagram: https://gitdiagram.com/matan-h/transfer
- Repository: https://github.com/matan-h/transfer

## Overview

Transfer is an Android LAN file-sharing app. A user chooses a shared folder, starts the foreground server, then gives another device the displayed address to browse or transfer files. In-app stages cover folder setup, file listing and management, and server/network state; settings add password and IP-permission controls. The README documents CLI and browser access, uploads, and clipboard paste. Source excerpts show key Android flows; several server routes and web-asset connections are documented but not visible in the excerpts, so those links are identified as documented or unverified.

Main entry points: [`app/src/main/java/com/matanh/transfer/MainActivity.kt`](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/MainActivity.kt) (Main screen), [`app/src/main/java/com/matanh/transfer/server/FileServerService.kt`](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/server/FileServerService.kt) (Server service), [`app/src/main/java/com/matanh/transfer/util/FileUtils.kt`](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/util/FileUtils.kt) (File operations), [`app/src/main/java/com/matanh/transfer/ui/MainViewModel.kt`](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/ui/MainViewModel.kt) (File view model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_android_ui["Android app"]
  node_setup["Folder setup<br/>[SetupActivity.kt]"]
  node_main["Main screen<br/>[MainActivity.kt]"]
  node_settings["Settings"]
  node_about["About screen<br/>[AboutActivity.kt]"]
  node_viewmodel["File view model<br/>[MainViewModel.kt]"]
  node_adapter["File list adapter<br/>[FileAdapter.kt]"]
  node_qr["Address QR<br/>[QRCodeGenerator.kt]"]
end

subgraph group_server["LAN server"]
  node_service["Server service"]
  node_ktor["HTTP server<br/>[KtorServer.kt]"]
  node_network["Network monitor<br/>[NetworkHelper.kt]"]
  node_state["Server state<br/>[ServerState.kt]"]
  node_ip_permissions["IP permissions<br/>[IpEntry.kt]"]
end

subgraph group_files["File handling"]
  node_share["Share handler<br/>[ShareHandler.kt]"]
  node_fileutils["File operations<br/>[FileUtils.kt]"]
  node_fileitem["File metadata<br/>[FileItem.kt]"]
  node_shared_folder[("Shared folder")]
end

subgraph group_web["Web access"]
  node_web_page["Web interface<br/>[index.html]"]
  node_web_script["Web interactions<br/>[script.js]"]
  node_lan_client(("LAN device"))
end

node_user(("Phone user"))

node_user -->|"chooses folder"| node_setup
node_setup -->|"persists access"| node_fileutils
node_setup -->|"opens app"| node_main
node_user -->|"manages files"| node_main
node_main -->|"observes files"| node_viewmodel
node_main -->|"updates list"| node_adapter
node_adapter -->|"formats sizes"| node_fileutils
node_viewmodel -->|"creates files"| node_fileutils
node_viewmodel -->|"lists and deletes"| node_shared_folder
node_fileutils -->|"copies and writes"| node_shared_folder
node_main -->|"handles shares"| node_share
node_share -->|"copies shared files"| node_fileutils
node_share -->|"refreshes listing"| node_viewmodel
node_main -->|"starts and binds"| node_service
node_service -->|"monitors network"| node_network
node_service -->|"updates status"| node_state
node_service -.->|"launches server"| node_ktor
node_lan_client -->|"requests files"| node_ktor
node_ktor -->|"serves and receives"| node_shared_folder
node_lan_client -->|"opens address"| node_web_page
node_web_page -.->|"loads interactions"| node_web_script
node_main -.->|"shows address"| node_qr
node_settings -.->|"configures protection"| node_service
node_service -.->|"requests approval"| node_ip_permissions
node_user -->|"sets preferences"| node_settings
node_user -.->|"views app info"| node_about

click node_setup "https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/ui/SetupActivity.kt"
click node_main "https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/MainActivity.kt"
click node_settings "https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/ui/SettingsActivity.kt"
click node_about "https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/ui/AboutActivity.kt"
click node_viewmodel "https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/ui/MainViewModel.kt"
click node_adapter "https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/util/FileAdapter.kt"
click node_share "https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/util/ShareHandler.kt"
click node_fileutils "https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/util/FileUtils.kt"
click node_fileitem "https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/util/FileItem.kt"
click node_service "https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/server/FileServerService.kt"
click node_ktor "https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/server/KtorServer.kt"
click node_network "https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/server/NetworkHelper.kt"
click node_state "https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/server/ServerState.kt"
click node_qr "https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/util/QRCodeGenerator.kt"
click node_ip_permissions "https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/util/IpEntry.kt"
click node_web_page "https://github.com/matan-h/transfer/blob/main/app/src/main/assets/index.html"
click node_web_script "https://github.com/matan-h/transfer/blob/main/app/src/main/assets/script.js"

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_setup,node_main,node_settings,node_about,node_viewmodel,node_adapter,node_qr,node_user toneBlue
class node_service,node_ktor,node_network,node_state,node_ip_permissions toneAmber
class node_share,node_fileutils,node_fileitem,node_shared_folder toneMint
class node_web_page,node_web_script,node_lan_client toneRose
```

## Components

### Android app

- [Folder setup](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/ui/SetupActivity.kt): `app/src/main/java/com/matanh/transfer/ui/SetupActivity.kt`
- [Main screen](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/MainActivity.kt): `app/src/main/java/com/matanh/transfer/MainActivity.kt`
- [Settings](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/ui/SettingsActivity.kt): `app/src/main/java/com/matanh/transfer/ui/SettingsActivity.kt`
- [About screen](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/ui/AboutActivity.kt): `app/src/main/java/com/matanh/transfer/ui/AboutActivity.kt`
- [File view model](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/ui/MainViewModel.kt): `app/src/main/java/com/matanh/transfer/ui/MainViewModel.kt`
- [File list adapter](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/util/FileAdapter.kt): `app/src/main/java/com/matanh/transfer/util/FileAdapter.kt`
- [Address QR](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/util/QRCodeGenerator.kt): `app/src/main/java/com/matanh/transfer/util/QRCodeGenerator.kt`

### LAN server

- [Server service](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/server/FileServerService.kt): `app/src/main/java/com/matanh/transfer/server/FileServerService.kt`
- [HTTP server](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/server/KtorServer.kt): `app/src/main/java/com/matanh/transfer/server/KtorServer.kt`
- [Network monitor](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/server/NetworkHelper.kt): `app/src/main/java/com/matanh/transfer/server/NetworkHelper.kt`
- [Server state](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/server/ServerState.kt): `app/src/main/java/com/matanh/transfer/server/ServerState.kt`
- [IP permissions](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/util/IpEntry.kt): `app/src/main/java/com/matanh/transfer/util/IpEntry.kt`

### File handling

- [Share handler](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/util/ShareHandler.kt): `app/src/main/java/com/matanh/transfer/util/ShareHandler.kt`
- [File operations](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/util/FileUtils.kt): `app/src/main/java/com/matanh/transfer/util/FileUtils.kt`
- [File metadata](https://github.com/matan-h/transfer/blob/main/app/src/main/java/com/matanh/transfer/util/FileItem.kt): `app/src/main/java/com/matanh/transfer/util/FileItem.kt`
- **Shared folder**

### Web access

- [Web interface](https://github.com/matan-h/transfer/blob/main/app/src/main/assets/index.html): `app/src/main/assets/index.html`
- [Web interactions](https://github.com/matan-h/transfer/blob/main/app/src/main/assets/script.js): `app/src/main/assets/script.js`
- **LAN device**

### Other components

- **Phone user**

## Connections

- Phone user → Folder setup: chooses folder (evidence: `app/src/main/java/com/matanh/transfer/ui/SetupActivity.kt`)
- Folder setup → File operations: persists access (evidence: `app/src/main/java/com/matanh/transfer/ui/SetupActivity.kt`)
- Folder setup → Main screen: opens app (evidence: `app/src/main/java/com/matanh/transfer/ui/SetupActivity.kt`)
- Phone user → Main screen: manages files (evidence: `README.md`)
- Main screen → File view model: observes files (evidence: `app/src/main/java/com/matanh/transfer/MainActivity.kt`)
- Main screen → File list adapter: updates list (evidence: `app/src/main/java/com/matanh/transfer/MainActivity.kt`)
- File list adapter → File operations: formats sizes (evidence: `app/src/main/java/com/matanh/transfer/util/FileAdapter.kt`)
- File view model → File operations: creates files (evidence: `app/src/main/java/com/matanh/transfer/ui/MainViewModel.kt`)
- File view model → Shared folder: lists and deletes (evidence: `app/src/main/java/com/matanh/transfer/ui/MainViewModel.kt`)
- File operations → Shared folder: copies and writes (evidence: `app/src/main/java/com/matanh/transfer/util/FileUtils.kt`)
- Main screen → Share handler: handles shares (evidence: `app/src/main/java/com/matanh/transfer/MainActivity.kt`)
- Share handler → File operations: copies shared files (evidence: `app/src/main/java/com/matanh/transfer/util/ShareHandler.kt`)
- Share handler → File view model: refreshes listing (evidence: `app/src/main/java/com/matanh/transfer/util/ShareHandler.kt`)
- Main screen → Server service: starts and binds (evidence: `app/src/main/java/com/matanh/transfer/MainActivity.kt`)
- Server service → Network monitor: monitors network (evidence: `app/src/main/java/com/matanh/transfer/server/FileServerService.kt`)
- Server service → Server state: updates status (evidence: `app/src/main/java/com/matanh/transfer/server/FileServerService.kt`)
- Server service → HTTP server: launches server (evidence: `app/src/main/java/com/matanh/transfer/server/KtorServer.kt`)
- LAN device → HTTP server: requests files (evidence: `README.md`)
- HTTP server → Shared folder: serves and receives (evidence: `README.md`)
- LAN device → Web interface: opens address (evidence: `README.md`)
- Web interface → Web interactions: loads interactions
- Main screen → Address QR: shows address (evidence: `app/src/main/java/com/matanh/transfer/MainActivity.kt`)
- Settings → Server service: configures protection
- Server service → IP permissions: requests approval
- Phone user → Settings: sets preferences (evidence: `README.md`)
- Phone user → About screen: views app info
