# pbatard/rufus architecture

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

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

## Overview

Rufus is a Windows utility for formatting removable or virtual media and producing bootable installation drives. The principal workflow is user configuration, media and image selection, filesystem formatting, boot-media installation, optional Windows customization or persistence setup, validation, and delivery to the target drive. The tree shows dedicated ISO, WIM, archive, filesystem, boot-sector, and device layers. Some orchestration details are inferred from documented capabilities because the main implementation excerpts were not provided.

Main entry points: [`src/rufus.c`](https://github.com/pbatard/rufus/blob/master/src/rufus.c) (Rufus Controller), [`src/dev.c`](https://github.com/pbatard/rufus/blob/master/src/dev.c) (Device I/O), [`src/format.c`](https://github.com/pbatard/rufus/blob/master/src/format.c) (Format Engine), [`src/ui.c`](https://github.com/pbatard/rufus/blob/master/src/ui.c) (Desktop UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Control and UI"]
  node_rufus["Rufus Controller<br/>[rufus.c]"]
  node_ui["Desktop UI<br/>[ui.c]"]
  node_settings["Settings State<br/>[settings.h]"]
  node_localization["Localization<br/>[localization.c]"]
end

subgraph group_media["Media Preparation"]
  node_drive["Drive Manager<br/>[drive.c]"]
  node_device_io["Device I/O<br/>[dev.c]"]
  node_format["Format Engine<br/>[format.c]"]
  node_fat_formatter["FAT Formatter<br/>[format_fat32.c]"]
  node_ext_formatter["Ext Formatter<br/>[format_ext.c]"]
  node_badblocks["Bad Blocks<br/>[badblocks.c]"]
end

subgraph group_content["Image and Content"]
  node_iso_reader["ISO Reader<br/>[iso9660_fs.c]"]
  node_wim_engine["WIM Engine<br/>[wim.c]"]
  node_archive_decoder["Archive Decoder<br/>[bled.c]"]
  node_image_writer["Virtual Image Writer<br/>[vhd.c]"]
  node_checksum["Image Checksums<br/>[hash.c]"]
end

subgraph group_boot["Boot and Validation"]
  node_boot_installer["Boot Installer<br/>[syslinux.c]"]
  node_boot_sectors["Boot Sectors<br/>[fat32.c]"]
  node_uefi_validation["UEFI Validation<br/>[efi.h]"]
  node_windows_customization["Windows Customization<br/>[wue.c]"]
end

subgraph group_integrations["External Integrations"]
  node_network["Image Downloader<br/>[net.c]"]
  node_smart["Drive Diagnostics<br/>[smart.c]"]
end

node_user(("User"))
node_target_media[("Target Media")]
node_source_image["Source Image"]
node_microsoft_services(("Microsoft Services"))

node_user -->|"configures"| node_ui
node_ui -->|"dispatches"| node_rufus
node_rufus -->|"reads state"| node_settings
node_ui -->|"loads text"| node_localization
node_rufus -->|"selects media"| node_drive
node_drive -->|"accesses device"| node_device_io
node_rufus -->|"formats media"| node_format
node_format -->|"formats FAT"| node_fat_formatter
node_format -->|"formats ext"| node_ext_formatter
node_format -->|"writes filesystem"| node_device_io
node_rufus -->|"reads ISO"| node_iso_reader
node_rufus -->|"processes WIM"| node_wim_engine
node_rufus -->|"decodes archives"| node_archive_decoder
node_rufus -->|"computes checksums"| node_checksum
node_rufus -->|"writes images"| node_image_writer
node_rufus -->|"installs boot"| node_boot_installer
node_boot_installer -->|"writes sectors"| node_boot_sectors
node_boot_installer -->|"writes boot data"| node_device_io
node_rufus -->|"customizes Windows"| node_windows_customization
node_rufus -->|"checks blocks"| node_badblocks
node_badblocks -->|"tests device"| node_device_io
node_rufus -->|"validates UEFI"| node_uefi_validation
node_rufus -->|"queries health"| node_smart
node_rufus -.->|"downloads images"| node_network
node_network -.->|"retrieves media"| node_microsoft_services
node_source_image -->|"provides ISO"| node_iso_reader
node_source_image -->|"provides WIM"| node_wim_engine
node_source_image -->|"provides archive"| node_archive_decoder
node_device_io -->|"writes target"| node_target_media
node_uefi_validation -->|"checks boot"| node_target_media

click node_rufus "https://github.com/pbatard/rufus/blob/master/src/rufus.c"
click node_ui "https://github.com/pbatard/rufus/blob/master/src/ui.c"
click node_settings "https://github.com/pbatard/rufus/blob/master/src/settings.h"
click node_localization "https://github.com/pbatard/rufus/blob/master/src/localization.c"
click node_drive "https://github.com/pbatard/rufus/blob/master/src/drive.c"
click node_device_io "https://github.com/pbatard/rufus/blob/master/src/dev.c"
click node_format "https://github.com/pbatard/rufus/blob/master/src/format.c"
click node_fat_formatter "https://github.com/pbatard/rufus/blob/master/src/format_fat32.c"
click node_ext_formatter "https://github.com/pbatard/rufus/blob/master/src/format_ext.c"
click node_badblocks "https://github.com/pbatard/rufus/blob/master/src/badblocks.c"
click node_iso_reader "https://github.com/pbatard/rufus/blob/master/src/libcdio/iso9660/iso9660_fs.c"
click node_wim_engine "https://github.com/pbatard/rufus/blob/master/src/wimlib/wim.c"
click node_archive_decoder "https://github.com/pbatard/rufus/blob/master/src/bled/bled.c"
click node_image_writer "https://github.com/pbatard/rufus/blob/master/src/vhd.c"
click node_checksum "https://github.com/pbatard/rufus/blob/master/src/hash.c"
click node_boot_installer "https://github.com/pbatard/rufus/blob/master/src/syslinux.c"
click node_boot_sectors "https://github.com/pbatard/rufus/blob/master/src/ms-sys/fat32.c"
click node_uefi_validation "https://github.com/pbatard/rufus/blob/master/src/efi.h"
click node_windows_customization "https://github.com/pbatard/rufus/blob/master/src/wue.c"
click node_network "https://github.com/pbatard/rufus/blob/master/src/net.c"
click node_smart "https://github.com/pbatard/rufus/blob/master/src/smart.c"

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_rufus,node_ui,node_settings,node_localization,node_user toneBlue
class node_drive,node_device_io,node_format,node_fat_formatter,node_ext_formatter,node_badblocks,node_target_media toneAmber
class node_iso_reader,node_wim_engine,node_archive_decoder,node_image_writer,node_checksum toneMint
class node_boot_installer,node_boot_sectors,node_uefi_validation,node_windows_customization toneRose
class node_network,node_smart,node_source_image,node_microsoft_services toneIndigo
```

## Components

### Control and UI

- [Rufus Controller](https://github.com/pbatard/rufus/blob/master/src/rufus.c): `src/rufus.c`
- [Desktop UI](https://github.com/pbatard/rufus/blob/master/src/ui.c): `src/ui.c`
- [Settings State](https://github.com/pbatard/rufus/blob/master/src/settings.h): `src/settings.h`
- [Localization](https://github.com/pbatard/rufus/blob/master/src/localization.c): `src/localization.c`

### Media Preparation

- [Drive Manager](https://github.com/pbatard/rufus/blob/master/src/drive.c): `src/drive.c`
- [Device I/O](https://github.com/pbatard/rufus/blob/master/src/dev.c): `src/dev.c`
- [Format Engine](https://github.com/pbatard/rufus/blob/master/src/format.c): `src/format.c`
- [FAT Formatter](https://github.com/pbatard/rufus/blob/master/src/format_fat32.c): `src/format_fat32.c`
- [Ext Formatter](https://github.com/pbatard/rufus/blob/master/src/format_ext.c): `src/format_ext.c`
- [Bad Blocks](https://github.com/pbatard/rufus/blob/master/src/badblocks.c): `src/badblocks.c`

### Image and Content

- [ISO Reader](https://github.com/pbatard/rufus/blob/master/src/libcdio/iso9660/iso9660_fs.c): `src/libcdio/iso9660/iso9660_fs.c`
- [WIM Engine](https://github.com/pbatard/rufus/blob/master/src/wimlib/wim.c): `src/wimlib/wim.c`
- [Archive Decoder](https://github.com/pbatard/rufus/blob/master/src/bled/bled.c): `src/bled/bled.c`
- [Virtual Image Writer](https://github.com/pbatard/rufus/blob/master/src/vhd.c): `src/vhd.c`
- [Image Checksums](https://github.com/pbatard/rufus/blob/master/src/hash.c): `src/hash.c`

### Boot and Validation

- [Boot Installer](https://github.com/pbatard/rufus/blob/master/src/syslinux.c): `src/syslinux.c`
- [Boot Sectors](https://github.com/pbatard/rufus/blob/master/src/ms-sys/fat32.c): `src/ms-sys/fat32.c`
- [UEFI Validation](https://github.com/pbatard/rufus/blob/master/src/efi.h): `src/efi.h`
- [Windows Customization](https://github.com/pbatard/rufus/blob/master/src/wue.c): `src/wue.c`

### External Integrations

- [Image Downloader](https://github.com/pbatard/rufus/blob/master/src/net.c): `src/net.c`
- [Drive Diagnostics](https://github.com/pbatard/rufus/blob/master/src/smart.c): `src/smart.c`

### Other components

- **User**
- **Target Media**
- **Source Image**
- **Microsoft Services**

## Connections

- User → Desktop UI: configures
- Desktop UI → Rufus Controller: dispatches
- Rufus Controller → Settings State: reads state
- Desktop UI → Localization: loads text
- Rufus Controller → Drive Manager: selects media
- Drive Manager → Device I/O: accesses device
- Rufus Controller → Format Engine: formats media
- Format Engine → FAT Formatter: formats FAT
- Format Engine → Ext Formatter: formats ext
- Format Engine → Device I/O: writes filesystem
- Rufus Controller → ISO Reader: reads ISO
- Rufus Controller → WIM Engine: processes WIM
- Rufus Controller → Archive Decoder: decodes archives
- Rufus Controller → Image Checksums: computes checksums
- Rufus Controller → Virtual Image Writer: writes images
- Rufus Controller → Boot Installer: installs boot
- Boot Installer → Boot Sectors: writes sectors
- Boot Installer → Device I/O: writes boot data
- Rufus Controller → Windows Customization: customizes Windows
- Rufus Controller → Bad Blocks: checks blocks
- Bad Blocks → Device I/O: tests device
- Rufus Controller → UEFI Validation: validates UEFI
- Rufus Controller → Drive Diagnostics: queries health
- Rufus Controller → Image Downloader: downloads images
- Image Downloader → Microsoft Services: retrieves media
- Source Image → ISO Reader: provides ISO
- Source Image → WIM Engine: provides WIM
- Source Image → Archive Decoder: provides archive
- Device I/O → Target Media: writes target
- UEFI Validation → Target Media: checks boot
