# kda2495/ipa_downloader architecture

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

- Interactive diagram: https://gitdiagram.com/kda2495/ipa_downloader
- Repository: https://github.com/kda2495/ipa_downloader

## Overview

IPA_Downloader is a cross-platform PowerShell tool for finding, purchasing, and downloading App Store apps previously acquired with the user's Apple account, and for checking and installing apps from an Apps folder. The documented flow is user input or a configured app list, app lookup and version choice, then purchase or download; installation is a separate capability. The README also documents platform launchers and bundled ipatool-cpp binaries. Source excerpts were unavailable, so relationships below are limited to README statements; the internal implementation details and exact Apps-folder path are not established.

Main entry points: [`IPA_Downloader.ps1`](https://github.com/kda2495/ipa_downloader/blob/main/IPA_Downloader.ps1) (Downloader workflow), [`Start_IPA_Downloader_Windows.bat`](https://github.com/kda2495/ipa_downloader/blob/main/Start_IPA_Downloader_Windows.bat) (Windows launcher), [`Start_IPA_Downloader_macOS.command`](https://github.com/kda2495/ipa_downloader/blob/main/Start_IPA_Downloader_macOS.command) (macOS launcher), [`Start_IPA_Downloader_Linux.sh`](https://github.com/kda2495/ipa_downloader/blob/main/Start_IPA_Downloader_Linux.sh) (Linux launcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Launch and inputs"]
  node_windows_launcher["Windows launcher"]
  node_macos_launcher["macOS launcher"]
  node_linux_launcher["Linux launcher"]
end

subgraph group_account["Account and discovery"]
  node_downloader["Downloader workflow<br/>[IPA_Downloader.ps1]"]
  node_account_auth["Apple account sign-in<br/>[IPA_Downloader.ps1]"]
  node_app_search["App search<br/>[IPA_Downloader.ps1]"]
  node_standard_list["Default app list<br/>[AppsList.txt]"]
  node_custom_list["Custom app list<br/>[AppsListCustom.txt]"]
end

subgraph group_acquisition["App acquisition"]
  node_version_choice["Version selection<br/>[IPA_Downloader.ps1]"]
  node_purchase["App purchase<br/>[IPA_Downloader.ps1]"]
  node_download["App download<br/>[IPA_Downloader.ps1]"]
end

subgraph group_installation["Device installation"]
  node_ios_check["Minimum iOS check<br/>[IPA_Downloader.ps1]"]
  node_install["App installation<br/>[IPA_Downloader.ps1]"]
end

subgraph group_runtime["Platform runtime"]
  node_ipatool_linux["ipatool-cpp Linux"]
  node_ipatool_mac["ipatool-cpp macOS"]
  node_ipatool_mac_arm["ipatool-cpp macOS ARM"]
  node_ipatool_win["ipatool-cpp Windows"]
  node_device_tools["Windows device tools"]
end

node_user(("User"))
node_app_store{{"Apple App Store"}}
node_device(("iOS device"))

node_user -->|"starts"| node_windows_launcher
node_user -->|"starts"| node_macos_launcher
node_user -->|"starts"| node_linux_launcher
node_windows_launcher -->|"launches"| node_downloader
node_macos_launcher -->|"launches"| node_downloader
node_linux_launcher -->|"launches"| node_downloader
node_user -->|"signs in"| node_account_auth
node_downloader -->|"provides"| node_account_auth
node_user -->|"searches"| node_app_search
node_downloader -->|"supports"| node_app_search
node_standard_list -->|"supplies apps"| node_app_search
node_custom_list -->|"supplies apps"| node_app_search
node_app_search -->|"offers versions"| node_version_choice
node_user -->|"chooses version"| node_version_choice
node_user -->|"requests purchase"| node_purchase
node_user -->|"requests download"| node_download
node_purchase -->|"purchases from"| node_app_store
node_download -->|"downloads from"| node_app_store
node_ipatool_linux -.->|"supports"| node_downloader
node_ipatool_mac -.->|"supports"| node_downloader
node_ipatool_mac_arm -.->|"supports"| node_downloader
node_ipatool_win -.->|"supports"| node_downloader
node_downloader -->|"checks compatibility"| node_ios_check
node_user -->|"requests installation"| node_install
node_downloader -->|"supports installation"| node_install
node_ios_check -.->|"precedes"| node_install
node_install -->|"installs on"| node_device
node_device_tools -.->|"supports"| node_install

click node_windows_launcher "https://github.com/kda2495/ipa_downloader/blob/main/Start_IPA_Downloader_Windows.bat"
click node_macos_launcher "https://github.com/kda2495/ipa_downloader/blob/main/Start_IPA_Downloader_macOS.command"
click node_linux_launcher "https://github.com/kda2495/ipa_downloader/blob/main/Start_IPA_Downloader_Linux.sh"
click node_downloader "https://github.com/kda2495/ipa_downloader/blob/main/IPA_Downloader.ps1"
click node_account_auth "https://github.com/kda2495/ipa_downloader/blob/main/IPA_Downloader.ps1"
click node_app_search "https://github.com/kda2495/ipa_downloader/blob/main/IPA_Downloader.ps1"
click node_standard_list "https://github.com/kda2495/ipa_downloader/blob/main/Files/AppsList.txt"
click node_custom_list "https://github.com/kda2495/ipa_downloader/blob/main/Files/AppsListCustom.txt"
click node_version_choice "https://github.com/kda2495/ipa_downloader/blob/main/IPA_Downloader.ps1"
click node_purchase "https://github.com/kda2495/ipa_downloader/blob/main/IPA_Downloader.ps1"
click node_download "https://github.com/kda2495/ipa_downloader/blob/main/IPA_Downloader.ps1"
click node_ipatool_linux "https://github.com/kda2495/ipa_downloader/blob/main/MainApp/linux_amd64/ipatool-cpp-linux-amd64"
click node_ipatool_mac "https://github.com/kda2495/ipa_downloader/blob/main/MainApp/macOS_amd64/ipatool-cpp-macOS-amd64"
click node_ipatool_mac_arm "https://github.com/kda2495/ipa_downloader/blob/main/MainApp/macOS_arm64/ipatool-cpp-macOS-arm64"
click node_ipatool_win "https://github.com/kda2495/ipa_downloader/blob/main/MainApp/windows_amd64/ipatool-cpp-windows-amd64.exe"
click node_ios_check "https://github.com/kda2495/ipa_downloader/blob/main/IPA_Downloader.ps1"
click node_install "https://github.com/kda2495/ipa_downloader/blob/main/IPA_Downloader.ps1"
click node_device_tools "https://github.com/kda2495/ipa_downloader/blob/main/MainApp/windows_amd64/ideviceinstaller.exe"

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_windows_launcher,node_macos_launcher,node_linux_launcher,node_user toneBlue
class node_downloader,node_account_auth,node_app_search,node_standard_list,node_custom_list toneAmber
class node_version_choice,node_purchase,node_download toneMint
class node_ios_check,node_install toneRose
class node_ipatool_linux,node_ipatool_mac,node_ipatool_mac_arm,node_ipatool_win,node_device_tools,node_app_store,node_device toneIndigo
```

## Components

### Launch and inputs

- [Windows launcher](https://github.com/kda2495/ipa_downloader/blob/main/Start_IPA_Downloader_Windows.bat): `Start_IPA_Downloader_Windows.bat`
- [macOS launcher](https://github.com/kda2495/ipa_downloader/blob/main/Start_IPA_Downloader_macOS.command): `Start_IPA_Downloader_macOS.command`
- [Linux launcher](https://github.com/kda2495/ipa_downloader/blob/main/Start_IPA_Downloader_Linux.sh): `Start_IPA_Downloader_Linux.sh`

### Account and discovery

- [Downloader workflow](https://github.com/kda2495/ipa_downloader/blob/main/IPA_Downloader.ps1): `IPA_Downloader.ps1`
- [Apple account sign-in](https://github.com/kda2495/ipa_downloader/blob/main/IPA_Downloader.ps1): `IPA_Downloader.ps1`
- [App search](https://github.com/kda2495/ipa_downloader/blob/main/IPA_Downloader.ps1): `IPA_Downloader.ps1`
- [Default app list](https://github.com/kda2495/ipa_downloader/blob/main/Files/AppsList.txt): `Files/AppsList.txt`
- [Custom app list](https://github.com/kda2495/ipa_downloader/blob/main/Files/AppsListCustom.txt): `Files/AppsListCustom.txt`

### App acquisition

- [Version selection](https://github.com/kda2495/ipa_downloader/blob/main/IPA_Downloader.ps1): `IPA_Downloader.ps1`
- [App purchase](https://github.com/kda2495/ipa_downloader/blob/main/IPA_Downloader.ps1): `IPA_Downloader.ps1`
- [App download](https://github.com/kda2495/ipa_downloader/blob/main/IPA_Downloader.ps1): `IPA_Downloader.ps1`

### Device installation

- [Minimum iOS check](https://github.com/kda2495/ipa_downloader/blob/main/IPA_Downloader.ps1): `IPA_Downloader.ps1`
- [App installation](https://github.com/kda2495/ipa_downloader/blob/main/IPA_Downloader.ps1): `IPA_Downloader.ps1`

### Platform runtime

- [ipatool-cpp Linux](https://github.com/kda2495/ipa_downloader/blob/main/MainApp/linux_amd64/ipatool-cpp-linux-amd64): `MainApp/linux_amd64/ipatool-cpp-linux-amd64`
- [ipatool-cpp macOS](https://github.com/kda2495/ipa_downloader/blob/main/MainApp/macOS_amd64/ipatool-cpp-macOS-amd64): `MainApp/macOS_amd64/ipatool-cpp-macOS-amd64`
- [ipatool-cpp macOS ARM](https://github.com/kda2495/ipa_downloader/blob/main/MainApp/macOS_arm64/ipatool-cpp-macOS-arm64): `MainApp/macOS_arm64/ipatool-cpp-macOS-arm64`
- [ipatool-cpp Windows](https://github.com/kda2495/ipa_downloader/blob/main/MainApp/windows_amd64/ipatool-cpp-windows-amd64.exe): `MainApp/windows_amd64/ipatool-cpp-windows-amd64.exe`
- [Windows device tools](https://github.com/kda2495/ipa_downloader/blob/main/MainApp/windows_amd64/ideviceinstaller.exe): `MainApp/windows_amd64/ideviceinstaller.exe`

### Other components

- **User**
- **Apple App Store**
- **iOS device**

## Connections

- User → Windows launcher: starts (evidence: `README.md`)
- User → macOS launcher: starts (evidence: `README.md`)
- User → Linux launcher: starts (evidence: `README.md`)
- Windows launcher → Downloader workflow: launches (evidence: `README.md`)
- macOS launcher → Downloader workflow: launches (evidence: `README.md`)
- Linux launcher → Downloader workflow: launches (evidence: `README.md`)
- User → Apple account sign-in: signs in (evidence: `README.md`)
- Downloader workflow → Apple account sign-in: provides (evidence: `README.md`)
- User → App search: searches (evidence: `README.md`)
- Downloader workflow → App search: supports (evidence: `README.md`)
- Default app list → App search: supplies apps (evidence: `README.md`)
- Custom app list → App search: supplies apps (evidence: `README.md`)
- App search → Version selection: offers versions (evidence: `README.md`)
- User → Version selection: chooses version (evidence: `README.md`)
- User → App purchase: requests purchase (evidence: `README.md`)
- User → App download: requests download (evidence: `README.md`)
- App purchase → Apple App Store: purchases from (evidence: `README.md`)
- App download → Apple App Store: downloads from (evidence: `README.md`)
- ipatool-cpp Linux → Downloader workflow: supports
- ipatool-cpp macOS → Downloader workflow: supports
- ipatool-cpp macOS ARM → Downloader workflow: supports
- ipatool-cpp Windows → Downloader workflow: supports
- Downloader workflow → Minimum iOS check: checks compatibility (evidence: `README.md`)
- User → App installation: requests installation (evidence: `README.md`)
- Downloader workflow → App installation: supports installation (evidence: `README.md`)
- Minimum iOS check → App installation: precedes
- App installation → iOS device: installs on (evidence: `README.md`)
- Windows device tools → App installation: supports
