# asherjn/recall architecture

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

- Interactive diagram: https://gitdiagram.com/asherjn/recall
- Repository: https://github.com/asherjn/recall

## Overview

Recall is a macOS launcher for playing Overwatch on Apple Silicon. The main user path runs from opening the app through setup and runtime preparation to Battle.net, where the player installs and launches the game. The app also manages installation locations and graphics settings, and provides highlight capture, input monitoring, updates, help, and diagnostic logs. The README documents the player-facing flow; source-index references support several app connections. Unsampled runtime details are represented only where the tree or documentation supports them.

Main entry points: [`app/Sources/AppModel.swift`](https://github.com/asherjn/recall/blob/main/app/Sources/AppModel.swift) (App Model), [`app/Sources/Main.swift`](https://github.com/asherjn/recall/blob/main/app/Sources/Main.swift) (App Entry), [`app/Sources/LogBundle.swift`](https://github.com/asherjn/recall/blob/main/app/Sources/LogBundle.swift) (Log Bundles), [`app/Sources/SetupView.swift`](https://github.com/asherjn/recall/blob/main/app/Sources/SetupView.swift) (Setup UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_launcher["Launcher and Setup"]
  node_app_entry["App Entry<br/>[Main.swift]"]
  node_app_model["App Model<br/>[AppModel.swift]"]
  node_setup_ui["Setup UI<br/>[SetupView.swift]"]
  node_setup_worker["Setup Service<br/>[SetupService.swift]"]
  node_install_location["Install Location"]
  node_battle_record["Battle.net Record"]
  node_launcher_style["Launcher Style"]
  node_window_fit["Window Fit<br/>[WindowFit.swift]"]
end

subgraph group_runtime["Game Runtime"]
  node_game_runtime["Game Runtime<br/>[derive_runtime.py]"]
  node_pipeline_prep["Pipeline Preparation"]
  node_renderer_settings["Renderer Settings"]
end

subgraph group_player_features["Player Features"]
  node_highlights["Highlights<br/>[Highlights.swift]"]
  node_highlight_encoder["Highlight Encoder"]
  node_input_monitoring["Input Monitoring"]
end

subgraph group_support["Support and Maintenance"]
  node_help["Help<br/>[HelpSheet.swift]"]
  node_logs["Log Bundles<br/>[LogBundle.swift]"]
  node_log_cleaner["Log Cleaner<br/>[LogCleaner.swift]"]
  node_logging["Logging<br/>[Logging.swift]"]
  node_updater["Update Service"]
  node_brand["Product Identity<br/>[Brand.swift]"]
end

node_player(("Player"))
node_battlenet["Battle.net"]

node_player -->|"opens"| node_app_entry
node_app_entry -->|"creates"| node_app_model
node_app_entry -->|"shows"| node_setup_ui
node_setup_ui -->|"drives"| node_app_model
node_app_model -->|"runs setup"| node_setup_worker
node_app_model -->|"uses"| node_install_location
node_app_model -->|"uses"| node_renderer_settings
node_app_model -->|"checks access"| node_input_monitoring
node_app_model -->|"uses"| node_battle_record
node_app_model -.->|"prepares runtime"| node_game_runtime
node_game_runtime -.->|"enables play"| node_battlenet
node_player -->|"signs in"| node_battlenet
node_battlenet -->|"installs game"| node_player
node_app_model -.->|"prepares shaders"| node_pipeline_prep
node_player -->|"reviews clips"| node_highlights
node_highlights -->|"encodes clips"| node_highlight_encoder
node_player -->|"opens help"| node_help
node_app_model -->|"saves diagnostics"| node_logs
node_logs -->|"cleans logs"| node_log_cleaner
node_logs -->|"reads records"| node_battle_record
node_player -->|"chooses updates"| node_updater
node_app_entry -->|"sizes window"| node_window_fit

click node_app_entry "https://github.com/asherjn/recall/blob/main/app/Sources/Main.swift"
click node_app_model "https://github.com/asherjn/recall/blob/main/app/Sources/AppModel.swift"
click node_setup_ui "https://github.com/asherjn/recall/blob/main/app/Sources/SetupView.swift"
click node_setup_worker "https://github.com/asherjn/recall/blob/main/app/Sources/SetupService.swift"
click node_install_location "https://github.com/asherjn/recall/blob/main/app/Sources/InstallLocation.swift"
click node_battle_record "https://github.com/asherjn/recall/blob/main/app/Sources/BattleNetRecord.swift"
click node_game_runtime "https://github.com/asherjn/recall/blob/main/scripts/derive_runtime.py"
click node_pipeline_prep "https://github.com/asherjn/recall/blob/main/scripts/prepare_dxmt_pipelines.py"
click node_renderer_settings "https://github.com/asherjn/recall/blob/main/app/Sources/RendererSettings.swift"
click node_highlights "https://github.com/asherjn/recall/blob/main/app/Sources/Highlights.swift"
click node_highlight_encoder "https://github.com/asherjn/recall/blob/main/app/Sources/HighlightEncoder.swift"
click node_input_monitoring "https://github.com/asherjn/recall/blob/main/app/Sources/InputMonitoring.swift"
click node_help "https://github.com/asherjn/recall/blob/main/app/Sources/HelpSheet.swift"
click node_logs "https://github.com/asherjn/recall/blob/main/app/Sources/LogBundle.swift"
click node_log_cleaner "https://github.com/asherjn/recall/blob/main/app/Sources/LogCleaner.swift"
click node_logging "https://github.com/asherjn/recall/blob/main/app/Sources/Logging.swift"
click node_updater "https://github.com/asherjn/recall/blob/main/app/Sources/UpdateService.swift"
click node_brand "https://github.com/asherjn/recall/blob/main/app/Sources/Brand.swift"
click node_launcher_style "https://github.com/asherjn/recall/blob/main/app/Sources/LauncherStyle.swift"
click node_window_fit "https://github.com/asherjn/recall/blob/main/app/Sources/WindowFit.swift"

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_entry,node_app_model,node_setup_ui,node_setup_worker,node_install_location,node_battle_record,node_launcher_style,node_window_fit toneBlue
class node_game_runtime,node_pipeline_prep,node_renderer_settings toneAmber
class node_highlights,node_highlight_encoder,node_input_monitoring toneMint
class node_help,node_logs,node_log_cleaner,node_logging,node_updater,node_brand toneRose
class node_player,node_battlenet toneIndigo
```

## Components

### Launcher and Setup

- [App Entry](https://github.com/asherjn/recall/blob/main/app/Sources/Main.swift): `app/Sources/Main.swift`
- [App Model](https://github.com/asherjn/recall/blob/main/app/Sources/AppModel.swift): `app/Sources/AppModel.swift`
- [Setup UI](https://github.com/asherjn/recall/blob/main/app/Sources/SetupView.swift): `app/Sources/SetupView.swift`
- [Setup Service](https://github.com/asherjn/recall/blob/main/app/Sources/SetupService.swift): `app/Sources/SetupService.swift`
- [Install Location](https://github.com/asherjn/recall/blob/main/app/Sources/InstallLocation.swift): `app/Sources/InstallLocation.swift`
- [Battle.net Record](https://github.com/asherjn/recall/blob/main/app/Sources/BattleNetRecord.swift): `app/Sources/BattleNetRecord.swift`
- [Launcher Style](https://github.com/asherjn/recall/blob/main/app/Sources/LauncherStyle.swift): `app/Sources/LauncherStyle.swift`
- [Window Fit](https://github.com/asherjn/recall/blob/main/app/Sources/WindowFit.swift): `app/Sources/WindowFit.swift`

### Game Runtime

- [Game Runtime](https://github.com/asherjn/recall/blob/main/scripts/derive_runtime.py): `scripts/derive_runtime.py`
- [Pipeline Preparation](https://github.com/asherjn/recall/blob/main/scripts/prepare_dxmt_pipelines.py): `scripts/prepare_dxmt_pipelines.py`
- [Renderer Settings](https://github.com/asherjn/recall/blob/main/app/Sources/RendererSettings.swift): `app/Sources/RendererSettings.swift`

### Player Features

- [Highlights](https://github.com/asherjn/recall/blob/main/app/Sources/Highlights.swift): `app/Sources/Highlights.swift`
- [Highlight Encoder](https://github.com/asherjn/recall/blob/main/app/Sources/HighlightEncoder.swift): `app/Sources/HighlightEncoder.swift`
- [Input Monitoring](https://github.com/asherjn/recall/blob/main/app/Sources/InputMonitoring.swift): `app/Sources/InputMonitoring.swift`

### Support and Maintenance

- [Help](https://github.com/asherjn/recall/blob/main/app/Sources/HelpSheet.swift): `app/Sources/HelpSheet.swift`
- [Log Bundles](https://github.com/asherjn/recall/blob/main/app/Sources/LogBundle.swift): `app/Sources/LogBundle.swift`
- [Log Cleaner](https://github.com/asherjn/recall/blob/main/app/Sources/LogCleaner.swift): `app/Sources/LogCleaner.swift`
- [Logging](https://github.com/asherjn/recall/blob/main/app/Sources/Logging.swift): `app/Sources/Logging.swift`
- [Update Service](https://github.com/asherjn/recall/blob/main/app/Sources/UpdateService.swift): `app/Sources/UpdateService.swift`
- [Product Identity](https://github.com/asherjn/recall/blob/main/app/Sources/Brand.swift): `app/Sources/Brand.swift`

### Other components

- **Player**
- **Battle.net**

## Connections

- Player → App Entry: opens (evidence: `README.md`)
- App Entry → App Model: creates (evidence: `app/Sources/Main.swift`)
- App Entry → Setup UI: shows (evidence: `app/Sources/Main.swift`)
- Setup UI → App Model: drives (evidence: `app/Sources/SetupView.swift`)
- App Model → Setup Service: runs setup (evidence: `app/Sources/AppModel.swift`)
- App Model → Install Location: uses (evidence: `app/Sources/AppModel.swift`)
- App Model → Renderer Settings: uses (evidence: `app/Sources/AppModel.swift`)
- App Model → Input Monitoring: checks access (evidence: `app/Sources/AppModel.swift`)
- App Model → Battle.net Record: uses (evidence: `app/Sources/AppModel.swift`)
- App Model → Game Runtime: prepares runtime
- Game Runtime → Battle.net: enables play
- Player → Battle.net: signs in (evidence: `README.md`)
- Battle.net → Player: installs game (evidence: `README.md`)
- App Model → Pipeline Preparation: prepares shaders
- Player → Highlights: reviews clips (evidence: `README.md`)
- Highlights → Highlight Encoder: encodes clips (evidence: `app/Sources/Highlights.swift`)
- Player → Help: opens help (evidence: `README.md`)
- App Model → Log Bundles: saves diagnostics (evidence: `app/Sources/AppModel.swift`)
- Log Bundles → Log Cleaner: cleans logs (evidence: `app/Sources/LogBundle.swift`)
- Log Bundles → Battle.net Record: reads records (evidence: `app/Sources/LogBundle.swift`)
- Player → Update Service: chooses updates (evidence: `README.md`)
- App Entry → Window Fit: sizes window (evidence: `app/Sources/Main.swift`)
