# sp00nznet/recomp-launcher architecture

> Architecture diagram of the GitHub repository sp00nznet/recomp-launcher, 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/sp00nznet/recomp-launcher
- Repository: https://github.com/sp00nznet/recomp-launcher

## Overview

recomp-launcher is a cross-platform GUI installer for game recompiled projects. A player selects a game, locates their own game files, chooses optional outputs, then builds by downloading the game repository and toolkit and running the repository’s setup script. The installer turns script output into progress and logs, then exposes generated launchers and optional shortcuts. The all-games catalog adds game selection and release-manifest retrieval. README-described workflow edges are cited there; sampled source confirms key implementations, but much of main.go and some subsystems were not shown.

Main entry points: [`main.go`](https://github.com/sp00nznet/recomp-launcher/blob/main/main.go) (Installer UI), [`all.go`](https://github.com/sp00nznet/recomp-launcher/blob/main/all.go) (Release Manifest), [`manifest.go`](https://github.com/sp00nznet/recomp-launcher/blob/main/manifest.go) (Game Discovery), [`fetch.go`](https://github.com/sp00nznet/recomp-launcher/blob/main/fetch.go) (Repository Fetch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_selection["Game Selection"]
  node_installer_ui["Installer UI<br/>[main.go]"]
  node_catalog["Game Catalog<br/>[all.go]"]
  node_release_manifest["Release Manifest<br/>[all.go]"]
  node_game_manifest["Game Manifest<br/>[manifest.go]"]
  node_game_discovery["Game Discovery<br/>[manifest.go]"]
  node_game_files["Player Game Files"]
  node_choice_selection["Output Choices<br/>[main.go]"]
end

subgraph group_install["Install Workflow"]
  node_repository_fetch["Repository Fetch<br/>[fetch.go]"]
end

subgraph group_runtime["Build Runtime"]
  node_setup_script["Setup Script<br/>[main.go]"]
  node_pty_adapter["Pseudo-terminal<br/>[term.go]"]
  node_platform_pty["Platform PTY<br/>[term_unix.go]"]
  node_build_progress["Progress and Logs<br/>[main.go]"]
end

subgraph group_launch["Launch and State"]
  node_launcher_outputs["Launcher Outputs<br/>[main.go]"]
  node_desktop_shortcuts["Desktop Shortcuts<br/>[main.go]"]
  node_build_state[("Build State<br/>[main.go]")]
  node_release_notice["Release Notice<br/>[fetch.go]"]
end

node_player(("Player"))
node_github["GitHub"]

node_player -->|"opens"| node_installer_ui
node_installer_ui -->|"loads catalog"| node_catalog
node_installer_ui -->|"selects game"| node_release_manifest
node_release_manifest -->|"fetches manifest"| node_github
node_installer_ui -->|"loads configuration"| node_game_manifest
node_installer_ui -->|"searches installs"| node_game_discovery
node_game_discovery -->|"checks files"| node_game_files
node_player -->|"chooses folder"| node_game_files
node_installer_ui -->|"offers choices"| node_choice_selection
node_installer_ui -->|"starts build"| node_repository_fetch
node_repository_fetch -->|"downloads archives"| node_github
node_installer_ui -->|"runs setup"| node_setup_script
node_setup_script -->|"runs through"| node_pty_adapter
node_pty_adapter -->|"uses platform PTY"| node_platform_pty
node_setup_script -->|"prints progress"| node_build_progress
node_installer_ui -->|"records output"| node_build_progress
node_setup_script -->|"leaves launchers"| node_launcher_outputs
node_player -->|"plays launcher"| node_launcher_outputs
node_player -->|"requests shortcuts"| node_desktop_shortcuts
node_installer_ui -->|"saves build state"| node_build_state
node_installer_ui -->|"checks releases"| node_release_notice
node_release_notice -->|"queries releases"| node_github

click node_installer_ui "https://github.com/sp00nznet/recomp-launcher/blob/main/main.go"
click node_catalog "https://github.com/sp00nznet/recomp-launcher/blob/main/all.go"
click node_release_manifest "https://github.com/sp00nznet/recomp-launcher/blob/main/all.go"
click node_game_manifest "https://github.com/sp00nznet/recomp-launcher/blob/main/manifest.go"
click node_game_discovery "https://github.com/sp00nznet/recomp-launcher/blob/main/manifest.go"
click node_choice_selection "https://github.com/sp00nznet/recomp-launcher/blob/main/main.go"
click node_repository_fetch "https://github.com/sp00nznet/recomp-launcher/blob/main/fetch.go"
click node_setup_script "https://github.com/sp00nznet/recomp-launcher/blob/main/main.go"
click node_pty_adapter "https://github.com/sp00nznet/recomp-launcher/blob/main/term/term.go"
click node_platform_pty "https://github.com/sp00nznet/recomp-launcher/blob/main/term/term_unix.go"
click node_build_progress "https://github.com/sp00nznet/recomp-launcher/blob/main/main.go"
click node_launcher_outputs "https://github.com/sp00nznet/recomp-launcher/blob/main/main.go"
click node_desktop_shortcuts "https://github.com/sp00nznet/recomp-launcher/blob/main/main.go"
click node_build_state "https://github.com/sp00nznet/recomp-launcher/blob/main/main.go"
click node_release_notice "https://github.com/sp00nznet/recomp-launcher/blob/main/fetch.go"

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_installer_ui,node_catalog,node_release_manifest,node_game_manifest,node_game_discovery,node_game_files,node_choice_selection toneBlue
class node_repository_fetch toneAmber
class node_setup_script,node_pty_adapter,node_platform_pty,node_build_progress toneMint
class node_launcher_outputs,node_desktop_shortcuts,node_build_state,node_release_notice toneRose
class node_player,node_github toneIndigo
```

## Components

### Game Selection

- [Installer UI](https://github.com/sp00nznet/recomp-launcher/blob/main/main.go): `main.go`
- [Game Catalog](https://github.com/sp00nznet/recomp-launcher/blob/main/all.go): `all.go`
- [Release Manifest](https://github.com/sp00nznet/recomp-launcher/blob/main/all.go): `all.go`
- [Game Manifest](https://github.com/sp00nznet/recomp-launcher/blob/main/manifest.go): `manifest.go`
- [Game Discovery](https://github.com/sp00nznet/recomp-launcher/blob/main/manifest.go): `manifest.go`
- **Player Game Files**
- [Output Choices](https://github.com/sp00nznet/recomp-launcher/blob/main/main.go): `main.go`

### Install Workflow

- [Repository Fetch](https://github.com/sp00nznet/recomp-launcher/blob/main/fetch.go): `fetch.go`

### Build Runtime

- [Setup Script](https://github.com/sp00nznet/recomp-launcher/blob/main/main.go): `main.go`
- [Pseudo-terminal](https://github.com/sp00nznet/recomp-launcher/blob/main/term/term.go): `term/term.go`
- [Platform PTY](https://github.com/sp00nznet/recomp-launcher/blob/main/term/term_unix.go): `term/term_unix.go`
- [Progress and Logs](https://github.com/sp00nznet/recomp-launcher/blob/main/main.go): `main.go`

### Launch and State

- [Launcher Outputs](https://github.com/sp00nznet/recomp-launcher/blob/main/main.go): `main.go`
- [Desktop Shortcuts](https://github.com/sp00nznet/recomp-launcher/blob/main/main.go): `main.go`
- [Build State](https://github.com/sp00nznet/recomp-launcher/blob/main/main.go): `main.go`
- [Release Notice](https://github.com/sp00nznet/recomp-launcher/blob/main/fetch.go): `fetch.go`

### Other components

- **Player**
- **GitHub**

## Connections

- Player → Installer UI: opens (evidence: `README.md`)
- Installer UI → Game Catalog: loads catalog (evidence: `all.go`)
- Installer UI → Release Manifest: selects game (evidence: `all.go`)
- Release Manifest → GitHub: fetches manifest (evidence: `all.go`)
- Installer UI → Game Manifest: loads configuration (evidence: `README.md`)
- Installer UI → Game Discovery: searches installs (evidence: `README.md`)
- Game Discovery → Player Game Files: checks files (evidence: `manifest.go`)
- Player → Player Game Files: chooses folder (evidence: `README.md`)
- Installer UI → Output Choices: offers choices (evidence: `README.md`)
- Installer UI → Repository Fetch: starts build (evidence: `README.md`)
- Repository Fetch → GitHub: downloads archives (evidence: `fetch.go`)
- Installer UI → Setup Script: runs setup (evidence: `README.md`)
- Setup Script → Pseudo-terminal: runs through (evidence: `main.go`)
- Pseudo-terminal → Platform PTY: uses platform PTY (evidence: `term/term_unix.go`)
- Setup Script → Progress and Logs: prints progress (evidence: `README.md`)
- Installer UI → Progress and Logs: records output (evidence: `README.md`)
- Setup Script → Launcher Outputs: leaves launchers (evidence: `README.md`)
- Player → Launcher Outputs: plays launcher (evidence: `README.md`)
- Player → Desktop Shortcuts: requests shortcuts (evidence: `README.md`)
- Installer UI → Build State: saves build state (evidence: `main.go`)
- Installer UI → Release Notice: checks releases (evidence: `fetch.go`)
- Release Notice → GitHub: queries releases (evidence: `fetch.go`)
