# debbuk/iphone-transfer architecture

> Architecture diagram of the GitHub repository debbuk/iphone-transfer, 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/debbuk/iphone-transfer
- Repository: https://github.com/debbuk/iphone-transfer

## Overview

iPhone Transfer is a single-file Windows GUI for moving selected files or zipped folders over USB into Documents by Readdle on an iPhone; the user then saves them into Files from that app. The main workflow runs from selection through device detection/pairing and transfer, with progress and logs surfaced in the GUI. The README documents AFC/house_arrest and the post-transfer iPhone steps; excerpts show the GUI callbacks, ZIP work, USB device selection, client creation, and streaming, but omit some transfer setup details.

Main entry points: [`iphone_transfer.py`](https://github.com/debbuk/iphone-transfer/blob/main/iphone_transfer.py) (App window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gui["Desktop interface"]
  node_app["App window<br/>[iphone_transfer.py]"]
  node_progress_log["Progress and log<br/>[iphone_transfer.py]"]
end

subgraph group_preparation["File preparation"]
  node_file_selection["File selection<br/>[iphone_transfer.py]"]
  node_folder_zip["Folder ZIP<br/>[iphone_transfer.py]"]
end

subgraph group_connection["USB connection"]
  node_device_detection["Device detection<br/>[iphone_transfer.py]"]
  node_usb_client["USB pairing client<br/>[iphone_transfer.py]"]
  node_pymobiledevice["pymobiledevice3"]
end

subgraph group_transfer["Transfer"]
  node_transfer_control["Transfer control<br/>[iphone_transfer.py]"]
  node_file_stream["File streaming<br/>[iphone_transfer.py]"]
  node_documents[("Documents Transfer folder")]
end

node_user(("Windows user"))
node_usbmux["Windows usbmux"]
node_iphone(("iPhone"))
node_save_to_files["Save into Files"]

node_user -->|"uses"| node_app
node_app -->|"selects files"| node_file_selection
node_file_selection -->|"zips folders"| node_folder_zip
node_app -->|"starts detection"| node_device_detection
node_device_detection -->|"selects device"| node_pymobiledevice
node_device_detection -->|"creates client"| node_usb_client
node_usb_client -->|"uses"| node_pymobiledevice
node_pymobiledevice -.->|"connects through"| node_usbmux
node_app -->|"starts transfer"| node_transfer_control
node_transfer_control -->|"selects and pairs"| node_pymobiledevice
node_transfer_control -->|"streams files"| node_file_stream
node_file_stream -->|"writes via AFC"| node_documents
node_documents -->|"stores files on"| node_iphone
node_transfer_control -->|"reports progress"| node_progress_log
node_user -->|"saves from iPhone"| node_save_to_files
node_save_to_files -->|"copies from"| node_documents

click node_app "https://github.com/debbuk/iphone-transfer/blob/main/iphone_transfer.py"
click node_file_selection "https://github.com/debbuk/iphone-transfer/blob/main/iphone_transfer.py"
click node_folder_zip "https://github.com/debbuk/iphone-transfer/blob/main/iphone_transfer.py"
click node_device_detection "https://github.com/debbuk/iphone-transfer/blob/main/iphone_transfer.py"
click node_usb_client "https://github.com/debbuk/iphone-transfer/blob/main/iphone_transfer.py"
click node_transfer_control "https://github.com/debbuk/iphone-transfer/blob/main/iphone_transfer.py"
click node_file_stream "https://github.com/debbuk/iphone-transfer/blob/main/iphone_transfer.py"
click node_progress_log "https://github.com/debbuk/iphone-transfer/blob/main/iphone_transfer.py"

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_app,node_progress_log,node_user toneBlue
class node_file_selection,node_folder_zip toneAmber
class node_device_detection,node_usb_client,node_pymobiledevice toneMint
class node_transfer_control,node_file_stream,node_documents toneRose
class node_usbmux,node_iphone,node_save_to_files toneIndigo
```

## Components

### Desktop interface

- [App window](https://github.com/debbuk/iphone-transfer/blob/main/iphone_transfer.py): `iphone_transfer.py`
- [Progress and log](https://github.com/debbuk/iphone-transfer/blob/main/iphone_transfer.py): `iphone_transfer.py`

### File preparation

- [File selection](https://github.com/debbuk/iphone-transfer/blob/main/iphone_transfer.py): `iphone_transfer.py`
- [Folder ZIP](https://github.com/debbuk/iphone-transfer/blob/main/iphone_transfer.py): `iphone_transfer.py`

### USB connection

- [Device detection](https://github.com/debbuk/iphone-transfer/blob/main/iphone_transfer.py): `iphone_transfer.py`
- [USB pairing client](https://github.com/debbuk/iphone-transfer/blob/main/iphone_transfer.py): `iphone_transfer.py`
- **pymobiledevice3**

### Transfer

- [Transfer control](https://github.com/debbuk/iphone-transfer/blob/main/iphone_transfer.py): `iphone_transfer.py`
- [File streaming](https://github.com/debbuk/iphone-transfer/blob/main/iphone_transfer.py): `iphone_transfer.py`
- **Documents Transfer folder**

### Other components

- **Windows user**
- **Windows usbmux**
- **iPhone**
- **Save into Files**

## Connections

- Windows user → App window: uses (evidence: `README.md`)
- App window → File selection: selects files (evidence: `iphone_transfer.py`)
- File selection → Folder ZIP: zips folders (evidence: `iphone_transfer.py`)
- App window → Device detection: starts detection (evidence: `iphone_transfer.py`)
- Device detection → pymobiledevice3: selects device (evidence: `iphone_transfer.py`)
- Device detection → USB pairing client: creates client (evidence: `iphone_transfer.py`)
- USB pairing client → pymobiledevice3: uses (evidence: `iphone_transfer.py`)
- pymobiledevice3 → Windows usbmux: connects through (evidence: `README.md`)
- App window → Transfer control: starts transfer (evidence: `iphone_transfer.py`)
- Transfer control → pymobiledevice3: selects and pairs (evidence: `iphone_transfer.py`)
- Transfer control → File streaming: streams files (evidence: `iphone_transfer.py`)
- File streaming → Documents Transfer folder: writes via AFC (evidence: `README.md`)
- Documents Transfer folder → iPhone: stores files on (evidence: `README.md`)
- Transfer control → Progress and log: reports progress (evidence: `iphone_transfer.py`)
- Windows user → Save into Files: saves from iPhone (evidence: `README.md`)
- Save into Files → Documents Transfer folder: copies from (evidence: `README.md`)
