# leviidev/podium architecture

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

- Interactive diagram: https://gitdiagram.com/leviidev/podium
- Repository: https://github.com/leviidev/podium

## Overview

Podium is an iOS app that emulates an iPod touch running iOS 6.1.6. The main user journey is to obtain or import firmware, inspect its IPSW contents and compatibility, prepare guest system and persistent storage, then start and interact with the emulated device. The graph includes firmware installation and guest-storage management alongside CPU execution and device I/O. Several runtime subsystems are represented at directory level because their wiring was not sampled; those uncertain links are omitted rather than inferred.

Main entry points: [`Podium/Firmware/RootFilesystem/RootFilesystemPreparer.swift`](https://github.com/leviidev/podium/blob/main/Podium/Firmware/RootFilesystem/RootFilesystemPreparer.swift) (Root filesystem preparation), [`Podium/Emulator/CPU/ARMv7/ARMv7CPU.swift`](https://github.com/leviidev/podium/blob/main/Podium/Emulator/CPU/ARMv7/ARMv7CPU.swift) (ARMv7 CPU), [`Podium/Firmware/Storage/FirmwareLibrary.swift`](https://github.com/leviidev/podium/blob/main/Podium/Firmware/Storage/FirmwareLibrary.swift) (Firmware library), [`Podium/Emulator/EmulatorCore.swift`](https://github.com/leviidev/podium/blob/main/Podium/Emulator/EmulatorCore.swift) (Emulator core)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and firmware"]
  node_root["App root<br/>[RootView.swift]"]
  node_firmware_library[("Firmware library")]
  node_downloader["Firmware download"]
  node_ipsw_parser["IPSW inspection<br/>[IPSWParser.swift]"]
  node_zip_reader["ZIP reader"]
end

subgraph group_guest["Guest preparation"]
  node_rootfs_prep["Root filesystem preparation"]
  node_rootfs_builder["HFS+ filesystem builder"]
  node_debian["Debian installer"]
  node_ipa["IPA installer<br/>[IPAInstaller.swift]"]
  node_guest_storage[("Persistent guest storage")]
end

subgraph group_runtime["Emulation runtime"]
  node_emulator_core["Emulator core<br/>[EmulatorCore.swift]"]
  node_session["Emulation session"]
  node_cpu["ARMv7 CPU<br/>[ARMv7CPU.swift]"]
  node_decoder["ARM and Thumb decoding<br/>[ARMDecoder.swift]"]
  node_thumb_decoder["Thumb decoding<br/>[ThumbDecoder.swift]"]
  node_jit["Native code translation<br/>[JITEngine.swift]"]
  node_dbt["Dynamic binary translation<br/>[DBTEngine.swift]"]
  node_memory["Guest memory bus<br/>[MemoryBus.swift]"]
end

subgraph group_devices["Virtual devices"]
  node_platform["iPod platform devices"]
  node_display["Display scanout"]
end

subgraph group_presentation["User interface"]
  node_firmware_ui["Firmware screens"]
  node_emulator_ui["Emulator controls"]
  node_rendering["Guest framebuffer view"]
  node_settings["Settings"]
end

node_user(("User"))

node_user -->|"opens app"| node_root
node_root -->|"provides library"| node_firmware_library
node_root -->|"provides emulator"| node_emulator_core
node_root -->|"shows screens"| node_firmware_ui
node_firmware_ui -.->|"manages firmware"| node_firmware_library
node_firmware_library -.->|"parses firmware"| node_ipsw_parser
node_ipsw_parser -->|"reads archive"| node_zip_reader
node_firmware_library -.->|"downloads firmware"| node_downloader
node_firmware_library -.->|"prepares guest image"| node_rootfs_prep
node_rootfs_prep -->|"inspects firmware"| node_ipsw_parser
node_rootfs_prep -->|"extracts archive entries"| node_zip_reader
node_rootfs_prep -->|"builds volume"| node_rootfs_builder
node_rootfs_prep -->|"installs packages"| node_debian
node_rootfs_prep -->|"installs apps"| node_ipa
node_settings -->|"manages firmware"| node_firmware_library
node_settings -->|"manages guest files"| node_guest_storage
node_guest_storage -->|"prepares and edits image"| node_rootfs_prep
node_settings -->|"checks busy state"| node_emulator_core
node_emulator_ui -.->|"controls emulation"| node_emulator_core
node_emulator_core -.->|"runs session"| node_session
node_cpu -->|"decodes ARM code"| node_decoder
node_cpu -->|"decodes Thumb code"| node_thumb_decoder
node_cpu -->|"requests compiled blocks"| node_jit
node_cpu -->|"uses translated execution"| node_dbt
node_cpu -->|"accesses guest memory"| node_memory
node_emulator_core -.->|"runs guest CPU"| node_cpu
node_emulator_core -.->|"configures platform"| node_platform
node_platform -.->|"provides display output"| node_display
node_rendering -->|"renders framebuffer"| node_display

click node_root "https://github.com/leviidev/podium/blob/main/Podium/App/RootView.swift"
click node_firmware_ui "https://github.com/leviidev/podium/tree/main/Podium/UI/Firmware"
click node_firmware_library "https://github.com/leviidev/podium/blob/main/Podium/Firmware/Storage/FirmwareLibrary.swift"
click node_downloader "https://github.com/leviidev/podium/tree/main/Podium/Firmware/Download"
click node_ipsw_parser "https://github.com/leviidev/podium/blob/main/Podium/Firmware/Parsing/IPSWParser.swift"
click node_zip_reader "https://github.com/leviidev/podium/blob/main/Podium/Firmware/Parsing/ZipArchiveReader.swift"
click node_rootfs_prep "https://github.com/leviidev/podium/blob/main/Podium/Firmware/RootFilesystem/RootFilesystemPreparer.swift"
click node_rootfs_builder "https://github.com/leviidev/podium/blob/main/Podium/Firmware/RootFilesystem/RootFilesystemBuilder.swift"
click node_debian "https://github.com/leviidev/podium/blob/main/Podium/Firmware/RootFilesystem/DebianPackageInstaller.swift"
click node_ipa "https://github.com/leviidev/podium/blob/main/Podium/Firmware/RootFilesystem/IPAInstaller.swift"
click node_guest_storage "https://github.com/leviidev/podium/blob/main/Podium/Emulator/Storage/PersistentGuestStorage.swift"
click node_emulator_ui "https://github.com/leviidev/podium/tree/main/Podium/UI/Emulator"
click node_emulator_core "https://github.com/leviidev/podium/blob/main/Podium/Emulator/EmulatorCore.swift"
click node_session "https://github.com/leviidev/podium/blob/main/Podium/Emulator/EmulationSession.swift"
click node_cpu "https://github.com/leviidev/podium/blob/main/Podium/Emulator/CPU/ARMv7/ARMv7CPU.swift"
click node_decoder "https://github.com/leviidev/podium/blob/main/Podium/Emulator/CPU/ARMv7/ARMDecoder.swift"
click node_thumb_decoder "https://github.com/leviidev/podium/blob/main/Podium/Emulator/CPU/ARMv7/ThumbDecoder.swift"
click node_jit "https://github.com/leviidev/podium/blob/main/Podium/Emulator/CPU/JIT/JITEngine.swift"
click node_dbt "https://github.com/leviidev/podium/blob/main/Podium/Emulator/CPU/DBT/DBTEngine.swift"
click node_memory "https://github.com/leviidev/podium/blob/main/Podium/Emulator/Memory/MemoryBus.swift"
click node_platform "https://github.com/leviidev/podium/tree/main/Podium/Emulator/Platform"
click node_display "https://github.com/leviidev/podium/tree/main/Podium/Emulator/Display"
click node_rendering "https://github.com/leviidev/podium/blob/main/Podium/Rendering/GuestFramebufferView.swift"
click node_settings "https://github.com/leviidev/podium/blob/main/Podium/UI/Settings/SettingsScreen.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_root,node_firmware_library,node_downloader,node_ipsw_parser,node_zip_reader,node_user toneBlue
class node_rootfs_prep,node_rootfs_builder,node_debian,node_ipa,node_guest_storage toneAmber
class node_emulator_core,node_session,node_cpu,node_decoder,node_thumb_decoder,node_jit,node_dbt,node_memory toneMint
class node_platform,node_display toneRose
class node_firmware_ui,node_emulator_ui,node_rendering,node_settings toneIndigo
```

## Components

### App and firmware

- [App root](https://github.com/leviidev/podium/blob/main/Podium/App/RootView.swift): `Podium/App/RootView.swift`
- [Firmware library](https://github.com/leviidev/podium/blob/main/Podium/Firmware/Storage/FirmwareLibrary.swift): `Podium/Firmware/Storage/FirmwareLibrary.swift`
- [Firmware download](https://github.com/leviidev/podium/tree/main/Podium/Firmware/Download): `Podium/Firmware/Download`
- [IPSW inspection](https://github.com/leviidev/podium/blob/main/Podium/Firmware/Parsing/IPSWParser.swift): `Podium/Firmware/Parsing/IPSWParser.swift`
- [ZIP reader](https://github.com/leviidev/podium/blob/main/Podium/Firmware/Parsing/ZipArchiveReader.swift): `Podium/Firmware/Parsing/ZipArchiveReader.swift`

### Guest preparation

- [Root filesystem preparation](https://github.com/leviidev/podium/blob/main/Podium/Firmware/RootFilesystem/RootFilesystemPreparer.swift): `Podium/Firmware/RootFilesystem/RootFilesystemPreparer.swift`
- [HFS+ filesystem builder](https://github.com/leviidev/podium/blob/main/Podium/Firmware/RootFilesystem/RootFilesystemBuilder.swift): `Podium/Firmware/RootFilesystem/RootFilesystemBuilder.swift`
- [Debian installer](https://github.com/leviidev/podium/blob/main/Podium/Firmware/RootFilesystem/DebianPackageInstaller.swift): `Podium/Firmware/RootFilesystem/DebianPackageInstaller.swift`
- [IPA installer](https://github.com/leviidev/podium/blob/main/Podium/Firmware/RootFilesystem/IPAInstaller.swift): `Podium/Firmware/RootFilesystem/IPAInstaller.swift`
- [Persistent guest storage](https://github.com/leviidev/podium/blob/main/Podium/Emulator/Storage/PersistentGuestStorage.swift): `Podium/Emulator/Storage/PersistentGuestStorage.swift`

### Emulation runtime

- [Emulator core](https://github.com/leviidev/podium/blob/main/Podium/Emulator/EmulatorCore.swift): `Podium/Emulator/EmulatorCore.swift`
- [Emulation session](https://github.com/leviidev/podium/blob/main/Podium/Emulator/EmulationSession.swift): `Podium/Emulator/EmulationSession.swift`
- [ARMv7 CPU](https://github.com/leviidev/podium/blob/main/Podium/Emulator/CPU/ARMv7/ARMv7CPU.swift): `Podium/Emulator/CPU/ARMv7/ARMv7CPU.swift`
- [ARM and Thumb decoding](https://github.com/leviidev/podium/blob/main/Podium/Emulator/CPU/ARMv7/ARMDecoder.swift): `Podium/Emulator/CPU/ARMv7/ARMDecoder.swift`
- [Thumb decoding](https://github.com/leviidev/podium/blob/main/Podium/Emulator/CPU/ARMv7/ThumbDecoder.swift): `Podium/Emulator/CPU/ARMv7/ThumbDecoder.swift`
- [Native code translation](https://github.com/leviidev/podium/blob/main/Podium/Emulator/CPU/JIT/JITEngine.swift): `Podium/Emulator/CPU/JIT/JITEngine.swift`
- [Dynamic binary translation](https://github.com/leviidev/podium/blob/main/Podium/Emulator/CPU/DBT/DBTEngine.swift): `Podium/Emulator/CPU/DBT/DBTEngine.swift`
- [Guest memory bus](https://github.com/leviidev/podium/blob/main/Podium/Emulator/Memory/MemoryBus.swift): `Podium/Emulator/Memory/MemoryBus.swift`

### Virtual devices

- [iPod platform devices](https://github.com/leviidev/podium/tree/main/Podium/Emulator/Platform): `Podium/Emulator/Platform`
- [Display scanout](https://github.com/leviidev/podium/tree/main/Podium/Emulator/Display): `Podium/Emulator/Display`

### User interface

- [Firmware screens](https://github.com/leviidev/podium/tree/main/Podium/UI/Firmware): `Podium/UI/Firmware`
- [Emulator controls](https://github.com/leviidev/podium/tree/main/Podium/UI/Emulator): `Podium/UI/Emulator`
- [Guest framebuffer view](https://github.com/leviidev/podium/blob/main/Podium/Rendering/GuestFramebufferView.swift): `Podium/Rendering/GuestFramebufferView.swift`
- [Settings](https://github.com/leviidev/podium/blob/main/Podium/UI/Settings/SettingsScreen.swift): `Podium/UI/Settings/SettingsScreen.swift`

### Other components

- **User**

## Connections

- User → App root: opens app (evidence: `Podium/App/RootView.swift`)
- App root → Firmware library: provides library (evidence: `Podium/App/RootView.swift`)
- App root → Emulator core: provides emulator (evidence: `Podium/App/RootView.swift`)
- App root → Firmware screens: shows screens (evidence: `Podium/App/RootView.swift`)
- Firmware screens → Firmware library: manages firmware
- Firmware library → IPSW inspection: parses firmware (evidence: `Podium/Firmware/Storage/FirmwareLibrary.swift`)
- IPSW inspection → ZIP reader: reads archive (evidence: `Podium/Firmware/Parsing/IPSWParser.swift`)
- Firmware library → Firmware download: downloads firmware
- Firmware library → Root filesystem preparation: prepares guest image
- Root filesystem preparation → IPSW inspection: inspects firmware (evidence: `Podium/Firmware/RootFilesystem/RootFilesystemPreparer.swift`)
- Root filesystem preparation → ZIP reader: extracts archive entries (evidence: `Podium/Firmware/RootFilesystem/RootFilesystemPreparer.swift`)
- Root filesystem preparation → HFS+ filesystem builder: builds volume (evidence: `Podium/Firmware/RootFilesystem/RootFilesystemPreparer.swift`)
- Root filesystem preparation → Debian installer: installs packages (evidence: `Podium/Firmware/RootFilesystem/RootFilesystemPreparer.swift`)
- Root filesystem preparation → IPA installer: installs apps (evidence: `Podium/Firmware/RootFilesystem/RootFilesystemPreparer.swift`)
- Settings → Firmware library: manages firmware (evidence: `Podium/UI/Settings/SettingsScreen.swift`)
- Settings → Persistent guest storage: manages guest files (evidence: `Podium/UI/Settings/SettingsScreen.swift`)
- Persistent guest storage → Root filesystem preparation: prepares and edits image (evidence: `Podium/Emulator/Storage/PersistentGuestStorage.swift`)
- Settings → Emulator core: checks busy state (evidence: `Podium/UI/Settings/SettingsScreen.swift`)
- Emulator controls → Emulator core: controls emulation
- Emulator core → Emulation session: runs session
- ARMv7 CPU → ARM and Thumb decoding: decodes ARM code (evidence: `Podium/Emulator/CPU/ARMv7/ARMv7CPU.swift`)
- ARMv7 CPU → Thumb decoding: decodes Thumb code (evidence: `Podium/Emulator/CPU/ARMv7/ARMv7CPU.swift`)
- ARMv7 CPU → Native code translation: requests compiled blocks (evidence: `Podium/Emulator/CPU/ARMv7/ARMv7CPU.swift`)
- ARMv7 CPU → Dynamic binary translation: uses translated execution (evidence: `Podium/Emulator/CPU/ARMv7/ARMv7CPU.swift`)
- ARMv7 CPU → Guest memory bus: accesses guest memory (evidence: `Podium/Emulator/CPU/ARMv7/ARMv7CPU.swift`)
- Emulator core → ARMv7 CPU: runs guest CPU
- Emulator core → iPod platform devices: configures platform
- iPod platform devices → Display scanout: provides display output
- Guest framebuffer view → Display scanout: renders framebuffer (evidence: `Podium/Rendering/GuestFramebufferView.swift`)
