# remenod/metabar architecture

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

- Interactive diagram: https://gitdiagram.com/remenod/metabar
- Repository: https://github.com/remenod/metabar

## Overview

Metabar is a freestanding x86 educational OS whose primary interaction is boot and kernel initialization, followed by an application selector that launches demos or the shell. The graph preserves the documented application, hardware, memory, paging, interrupt, settings, filesystem, and graphics capabilities. Edges reflect the kernel and app-selector excerpts, README statements, and explicit source references; unsampled subsystem internals are represented conservatively, with no speculative call chains.

Main entry points: [`src/kernel/core/kernel.c`](https://github.com/remenod/metabar/blob/master/src/kernel/core/kernel.c) (Kernel startup), [`src/apps/app_selector/app_selector.c`](https://github.com/remenod/metabar/blob/master/src/apps/app_selector/app_selector.c) (App selector), [`src/apps/screensaver/screensaver.c`](https://github.com/remenod/metabar/blob/master/src/apps/screensaver/screensaver.c) (Screensaver), [`src/kernel/fat32.c`](https://github.com/remenod/metabar/blob/master/src/kernel/fat32.c) (FAT32 filesystem)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_boot["Kernel Runtime"]
  node_kernel["Kernel startup<br/>[kernel.c]"]
end

subgraph group_hardware["x86 Hardware"]
  node_paging["Paging and GDT<br/>[paging.c]"]
  node_a20["A20 control<br/>[a20.c]"]
  node_interrupts["Interrupts and exceptions<br/>[idt.c]"]
  node_timer["PIT timer<br/>[pit.c]"]
  node_keyboard["Keyboard driver<br/>[keyboard.c]"]
  node_mouse["Mouse driver<br/>[mouse.c]"]
  node_vga["VGA display<br/>[vga.c]"]
  node_screen["Screen interface<br/>[screen.c]"]
  node_speaker["Speaker driver<br/>[speaker.c]"]
end

subgraph group_apps["Applications"]
  node_selector["App selector<br/>[app_selector.c]"]
  node_shell["Shell<br/>[shell.c]"]
  node_atto["Atto editor<br/>[atto.c]"]
  node_settings_app["Settings manager<br/>[settings_manager.c]"]
  node_snake["Snake<br/>[snake.c]"]
  node_text_sandbox["Text sandbox<br/>[text_sandbox.c]"]
  node_roulette["RSoD roulette<br/>[rsod_roulette.c]"]
  node_mouse_playground["Mouse playground"]
  node_screensaver["Screensaver<br/>[screensaver.c]"]
  node_segment["Segment test<br/>[segment_test.c]"]
end

subgraph group_services["Kernel Services"]
  node_memory["Heap and memory<br/>[memory.c]"]
  node_settings["Settings service<br/>[settings.c]"]
  node_diagnostics["Panic diagnostics<br/>[rsod_routine.c]"]
end

subgraph group_storage["Storage"]
  node_ramdisk["Ramdisk<br/>[ramdisk.c]"]
  node_fat32["FAT32 filesystem<br/>[fat32.c]"]
  node_block["Block device layer<br/>[block.c]"]
  node_dma["DMA support<br/>[dma.c]"]
end

node_bios(("BIOS / MBR"))

node_bios -.->|"boots"| node_kernel
node_kernel -->|"enables"| node_a20
node_kernel -->|"initializes"| node_paging
node_kernel -->|"reads and maps"| node_ramdisk
node_kernel -->|"mounts"| node_fat32
node_kernel -->|"initializes"| node_settings
node_kernel -->|"installs"| node_interrupts
node_kernel -->|"initializes"| node_timer
node_kernel -->|"initializes heap"| node_memory
node_kernel -->|"installs"| node_mouse
node_kernel -->|"installs"| node_keyboard
node_kernel -->|"tests modes"| node_vga
node_kernel -->|"launches"| node_selector
node_selector -->|"launches"| node_snake
node_selector -->|"launches"| node_text_sandbox
node_selector -->|"launches"| node_roulette
node_selector -->|"launches"| node_segment
node_selector -->|"launches"| node_mouse_playground
node_selector -->|"launches"| node_settings_app
node_selector -->|"launches"| node_shell
node_shell -->|"opens editor"| node_atto
node_shell -->|"starts"| node_screensaver
node_shell -->|"reads and writes"| node_fat32
node_atto -->|"loads and saves"| node_fat32
node_settings_app -->|"reads values"| node_settings
node_settings_app -.->|"reads input"| node_keyboard
node_settings_app -.->|"handles input"| node_mouse
node_screensaver -->|"loads music"| node_fat32
node_screensaver -->|"allocates buffers"| node_memory
node_screensaver -->|"registers tick"| node_timer
node_screensaver -->|"plays notes"| node_speaker
node_screensaver -->|"sets palette"| node_vga
node_screensaver -->|"draws frames"| node_screen
node_kernel -->|"initializes warnings"| node_diagnostics
node_fat32 -.->|"uses device layer"| node_block
node_ramdisk -.->|"provides storage"| node_block
node_kernel -.->|"initializes support"| node_dma

click node_kernel "https://github.com/remenod/metabar/blob/master/src/kernel/core/kernel.c"
click node_selector "https://github.com/remenod/metabar/blob/master/src/apps/app_selector/app_selector.c"
click node_shell "https://github.com/remenod/metabar/blob/master/src/apps/shell/shell.c"
click node_atto "https://github.com/remenod/metabar/blob/master/src/apps/atto/atto.c"
click node_settings_app "https://github.com/remenod/metabar/blob/master/src/apps/settings_manager/settings_manager.c"
click node_snake "https://github.com/remenod/metabar/blob/master/src/apps/snake/snake.c"
click node_text_sandbox "https://github.com/remenod/metabar/blob/master/src/apps/text_sandbox/text_sandbox.c"
click node_roulette "https://github.com/remenod/metabar/blob/master/src/apps/rsod_roulette/rsod_roulette.c"
click node_mouse_playground "https://github.com/remenod/metabar/blob/master/src/apps/mouse_playground/mouse_playground.cpp"
click node_screensaver "https://github.com/remenod/metabar/blob/master/src/apps/screensaver/screensaver.c"
click node_segment "https://github.com/remenod/metabar/blob/master/src/apps/segment_test/segment_test.c"
click node_paging "https://github.com/remenod/metabar/blob/master/src/arch/x86/paging/paging.c"
click node_a20 "https://github.com/remenod/metabar/blob/master/src/arch/x86/a20.c"
click node_interrupts "https://github.com/remenod/metabar/blob/master/src/arch/x86/interrupts/idt.c"
click node_timer "https://github.com/remenod/metabar/blob/master/src/arch/x86/timer/pit.c"
click node_keyboard "https://github.com/remenod/metabar/blob/master/src/kernel/drivers/keyboard.c"
click node_mouse "https://github.com/remenod/metabar/blob/master/src/kernel/drivers/mouse.c"
click node_vga "https://github.com/remenod/metabar/blob/master/src/kernel/drivers/vga.c"
click node_screen "https://github.com/remenod/metabar/blob/master/src/kernel/drivers/screen.c"
click node_speaker "https://github.com/remenod/metabar/blob/master/src/kernel/drivers/speaker.c"
click node_memory "https://github.com/remenod/metabar/blob/master/src/kernel/memory.c"
click node_settings "https://github.com/remenod/metabar/blob/master/src/kernel/settings.c"
click node_diagnostics "https://github.com/remenod/metabar/blob/master/src/arch/x86/diagnostics/rsod_routine.c"
click node_ramdisk "https://github.com/remenod/metabar/blob/master/src/kernel/ramdisk.c"
click node_fat32 "https://github.com/remenod/metabar/blob/master/src/kernel/fat32.c"
click node_block "https://github.com/remenod/metabar/blob/master/src/kernel/block.c"
click node_dma "https://github.com/remenod/metabar/blob/master/src/kernel/dma.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_kernel toneBlue
class node_paging,node_a20,node_interrupts,node_timer,node_keyboard,node_mouse,node_vga,node_screen,node_speaker toneAmber
class node_selector,node_shell,node_atto,node_settings_app,node_snake,node_text_sandbox,node_roulette,node_mouse_playground,node_screensaver,node_segment toneMint
class node_memory,node_settings,node_diagnostics toneRose
class node_ramdisk,node_fat32,node_block,node_dma,node_bios toneIndigo
```

## Components

### Kernel Runtime

- [Kernel startup](https://github.com/remenod/metabar/blob/master/src/kernel/core/kernel.c): `src/kernel/core/kernel.c`

### x86 Hardware

- [Paging and GDT](https://github.com/remenod/metabar/blob/master/src/arch/x86/paging/paging.c): `src/arch/x86/paging/paging.c`
- [A20 control](https://github.com/remenod/metabar/blob/master/src/arch/x86/a20.c): `src/arch/x86/a20.c`
- [Interrupts and exceptions](https://github.com/remenod/metabar/blob/master/src/arch/x86/interrupts/idt.c): `src/arch/x86/interrupts/idt.c`
- [PIT timer](https://github.com/remenod/metabar/blob/master/src/arch/x86/timer/pit.c): `src/arch/x86/timer/pit.c`
- [Keyboard driver](https://github.com/remenod/metabar/blob/master/src/kernel/drivers/keyboard.c): `src/kernel/drivers/keyboard.c`
- [Mouse driver](https://github.com/remenod/metabar/blob/master/src/kernel/drivers/mouse.c): `src/kernel/drivers/mouse.c`
- [VGA display](https://github.com/remenod/metabar/blob/master/src/kernel/drivers/vga.c): `src/kernel/drivers/vga.c`
- [Screen interface](https://github.com/remenod/metabar/blob/master/src/kernel/drivers/screen.c): `src/kernel/drivers/screen.c`
- [Speaker driver](https://github.com/remenod/metabar/blob/master/src/kernel/drivers/speaker.c): `src/kernel/drivers/speaker.c`

### Applications

- [App selector](https://github.com/remenod/metabar/blob/master/src/apps/app_selector/app_selector.c): `src/apps/app_selector/app_selector.c`
- [Shell](https://github.com/remenod/metabar/blob/master/src/apps/shell/shell.c): `src/apps/shell/shell.c`
- [Atto editor](https://github.com/remenod/metabar/blob/master/src/apps/atto/atto.c): `src/apps/atto/atto.c`
- [Settings manager](https://github.com/remenod/metabar/blob/master/src/apps/settings_manager/settings_manager.c): `src/apps/settings_manager/settings_manager.c`
- [Snake](https://github.com/remenod/metabar/blob/master/src/apps/snake/snake.c): `src/apps/snake/snake.c`
- [Text sandbox](https://github.com/remenod/metabar/blob/master/src/apps/text_sandbox/text_sandbox.c): `src/apps/text_sandbox/text_sandbox.c`
- [RSoD roulette](https://github.com/remenod/metabar/blob/master/src/apps/rsod_roulette/rsod_roulette.c): `src/apps/rsod_roulette/rsod_roulette.c`
- [Mouse playground](https://github.com/remenod/metabar/blob/master/src/apps/mouse_playground/mouse_playground.cpp): `src/apps/mouse_playground/mouse_playground.cpp`
- [Screensaver](https://github.com/remenod/metabar/blob/master/src/apps/screensaver/screensaver.c): `src/apps/screensaver/screensaver.c`
- [Segment test](https://github.com/remenod/metabar/blob/master/src/apps/segment_test/segment_test.c): `src/apps/segment_test/segment_test.c`

### Kernel Services

- [Heap and memory](https://github.com/remenod/metabar/blob/master/src/kernel/memory.c): `src/kernel/memory.c`
- [Settings service](https://github.com/remenod/metabar/blob/master/src/kernel/settings.c): `src/kernel/settings.c`
- [Panic diagnostics](https://github.com/remenod/metabar/blob/master/src/arch/x86/diagnostics/rsod_routine.c): `src/arch/x86/diagnostics/rsod_routine.c`

### Storage

- [Ramdisk](https://github.com/remenod/metabar/blob/master/src/kernel/ramdisk.c): `src/kernel/ramdisk.c`
- [FAT32 filesystem](https://github.com/remenod/metabar/blob/master/src/kernel/fat32.c): `src/kernel/fat32.c`
- [Block device layer](https://github.com/remenod/metabar/blob/master/src/kernel/block.c): `src/kernel/block.c`
- [DMA support](https://github.com/remenod/metabar/blob/master/src/kernel/dma.c): `src/kernel/dma.c`

### Other components

- **BIOS / MBR**

## Connections

- BIOS / MBR → Kernel startup: boots
- Kernel startup → A20 control: enables (evidence: `src/kernel/core/kernel.c`)
- Kernel startup → Paging and GDT: initializes (evidence: `src/kernel/core/kernel.c`)
- Kernel startup → Ramdisk: reads and maps (evidence: `src/kernel/core/kernel.c`)
- Kernel startup → FAT32 filesystem: mounts (evidence: `src/kernel/core/kernel.c`)
- Kernel startup → Settings service: initializes (evidence: `src/kernel/core/kernel.c`)
- Kernel startup → Interrupts and exceptions: installs (evidence: `src/kernel/core/kernel.c`)
- Kernel startup → PIT timer: initializes (evidence: `src/kernel/core/kernel.c`)
- Kernel startup → Heap and memory: initializes heap (evidence: `src/kernel/core/kernel.c`)
- Kernel startup → Mouse driver: installs (evidence: `src/kernel/core/kernel.c`)
- Kernel startup → Keyboard driver: installs (evidence: `src/kernel/core/kernel.c`)
- Kernel startup → VGA display: tests modes (evidence: `src/kernel/core/kernel.c`)
- Kernel startup → App selector: launches (evidence: `src/kernel/core/kernel.c`)
- App selector → Snake: launches (evidence: `src/apps/app_selector/app_selector.c`)
- App selector → Text sandbox: launches (evidence: `src/apps/app_selector/app_selector.c`)
- App selector → RSoD roulette: launches (evidence: `src/apps/app_selector/app_selector.c`)
- App selector → Segment test: launches (evidence: `src/apps/app_selector/app_selector.c`)
- App selector → Mouse playground: launches (evidence: `src/apps/app_selector/app_selector.c`)
- App selector → Settings manager: launches (evidence: `src/apps/app_selector/app_selector.c`)
- App selector → Shell: launches (evidence: `src/apps/app_selector/app_selector.c`)
- Shell → Atto editor: opens editor (evidence: `src/apps/shell/shell.c`)
- Shell → Screensaver: starts (evidence: `src/apps/shell/shell.c`)
- Shell → FAT32 filesystem: reads and writes (evidence: `src/apps/shell/shell.c`)
- Atto editor → FAT32 filesystem: loads and saves (evidence: `src/apps/atto/atto.c`)
- Settings manager → Settings service: reads values (evidence: `src/apps/settings_manager/settings_manager.c`)
- Settings manager → Keyboard driver: reads input (evidence: `src/apps/settings_manager/settings_manager.c`)
- Settings manager → Mouse driver: handles input (evidence: `src/apps/settings_manager/settings_manager.c`)
- Screensaver → FAT32 filesystem: loads music (evidence: `src/apps/screensaver/screensaver.c`)
- Screensaver → Heap and memory: allocates buffers (evidence: `src/apps/screensaver/screensaver.c`)
- Screensaver → PIT timer: registers tick (evidence: `src/apps/screensaver/screensaver.c`)
- Screensaver → Speaker driver: plays notes (evidence: `src/apps/screensaver/screensaver.c`)
- Screensaver → VGA display: sets palette (evidence: `src/apps/screensaver/screensaver.c`)
- Screensaver → Screen interface: draws frames (evidence: `src/apps/screensaver/screensaver.c`)
- Kernel startup → Panic diagnostics: initializes warnings (evidence: `src/kernel/core/kernel.c`)
- FAT32 filesystem → Block device layer: uses device layer
- Ramdisk → Block device layer: provides storage
- Kernel startup → DMA support: initializes support
