# pbatard/fido architecture

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

- Interactive diagram: https://gitdiagram.com/pbatard/fido
- Repository: https://github.com/pbatard/fido

## Overview

Fido is a single-script PowerShell utility for resolving official Microsoft Windows retail ISO downloads, usable through a GUI or command line, and for accessing bootable UEFI Shell images. The documented Windows flow selects version, release, edition, language, and architecture, queries Microsoft for languages and download links, then launches the download or displays its URL. Source excerpts were unavailable, so this map uses only README-documented capabilities and relationships; internal implementation stages are represented within the script rather than inferred as separate modules.

Main entry points: [`Fido.ps1`](https://github.com/pbatard/fido/blob/master/Fido.ps1) (Command-line mode)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_user_modes["User modes"]
  node_fido_script["Fido script<br/>[Fido.ps1]"]
  node_gui["GUI mode<br/>[Fido.ps1]"]
  node_cli["Command-line mode<br/>[Fido.ps1]"]
end

subgraph group_iso_resolution["ISO resolution"]
  node_windows_selection["Windows selection<br/>[Fido.ps1]"]
  node_language_lookup["Language lookup<br/>[Fido.ps1]"]
  node_link_lookup["Download-link lookup<br/>[Fido.ps1]"]
end

subgraph group_download_results["Download results"]
  node_download_action["Launch download<br/>[Fido.ps1]"]
  node_url_output["Display URL<br/>[Fido.ps1]"]
end

subgraph group_shell_images["Shell images"]
  node_uefi_shell["UEFI Shell images<br/>[Fido.ps1]"]
end

node_user(("User"))
node_microsoft{{"Microsoft download service"}}

node_user -->|"runs"| node_fido_script
node_fido_script -->|"instantiates"| node_gui
node_fido_script -->|"supports"| node_cli
node_cli -->|"selects options"| node_windows_selection
node_gui -.->|"selects Windows"| node_windows_selection
node_windows_selection -->|"requests languages"| node_language_lookup
node_language_lookup -->|"queries API"| node_microsoft
node_language_lookup -->|"requests links"| node_link_lookup
node_link_lookup -->|"queries API"| node_microsoft
node_cli -->|"launches download"| node_download_action
node_cli -->|"displays URL"| node_url_output
node_user -->|"accesses images"| node_uefi_shell

click node_fido_script "https://github.com/pbatard/fido/blob/master/Fido.ps1"
click node_gui "https://github.com/pbatard/fido/blob/master/Fido.ps1"
click node_cli "https://github.com/pbatard/fido/blob/master/Fido.ps1"
click node_windows_selection "https://github.com/pbatard/fido/blob/master/Fido.ps1"
click node_language_lookup "https://github.com/pbatard/fido/blob/master/Fido.ps1"
click node_link_lookup "https://github.com/pbatard/fido/blob/master/Fido.ps1"
click node_download_action "https://github.com/pbatard/fido/blob/master/Fido.ps1"
click node_url_output "https://github.com/pbatard/fido/blob/master/Fido.ps1"
click node_uefi_shell "https://github.com/pbatard/fido/blob/master/Fido.ps1"

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_fido_script,node_gui,node_cli,node_user toneBlue
class node_windows_selection,node_language_lookup,node_link_lookup toneAmber
class node_download_action,node_url_output toneMint
class node_uefi_shell toneRose
class node_microsoft toneIndigo
```

## Components

### User modes

- [Fido script](https://github.com/pbatard/fido/blob/master/Fido.ps1): `Fido.ps1`
- [GUI mode](https://github.com/pbatard/fido/blob/master/Fido.ps1): `Fido.ps1`
- [Command-line mode](https://github.com/pbatard/fido/blob/master/Fido.ps1): `Fido.ps1`

### ISO resolution

- [Windows selection](https://github.com/pbatard/fido/blob/master/Fido.ps1): `Fido.ps1`
- [Language lookup](https://github.com/pbatard/fido/blob/master/Fido.ps1): `Fido.ps1`
- [Download-link lookup](https://github.com/pbatard/fido/blob/master/Fido.ps1): `Fido.ps1`

### Download results

- [Launch download](https://github.com/pbatard/fido/blob/master/Fido.ps1): `Fido.ps1`
- [Display URL](https://github.com/pbatard/fido/blob/master/Fido.ps1): `Fido.ps1`

### Shell images

- [UEFI Shell images](https://github.com/pbatard/fido/blob/master/Fido.ps1): `Fido.ps1`

### Other components

- **User**
- **Microsoft download service**

## Connections

- User → Fido script: runs (evidence: `README.md`)
- Fido script → GUI mode: instantiates (evidence: `README.md`)
- Fido script → Command-line mode: supports (evidence: `README.md`)
- Command-line mode → Windows selection: selects options (evidence: `README.md`)
- GUI mode → Windows selection: selects Windows
- Windows selection → Language lookup: requests languages (evidence: `README.md`)
- Language lookup → Microsoft download service: queries API (evidence: `README.md`)
- Language lookup → Download-link lookup: requests links (evidence: `README.md`)
- Download-link lookup → Microsoft download service: queries API (evidence: `README.md`)
- Command-line mode → Launch download: launches download (evidence: `README.md`)
- Command-line mode → Display URL: displays URL (evidence: `README.md`)
- User → UEFI Shell images: accesses images (evidence: `README.md`)
