# shivter14/shivtanium architecture

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

- Interactive diagram: https://gitdiagram.com/shivter14/shivtanium
- Repository: https://github.com/shivter14/shivtanium

## Overview

Shivtanium is a Batch-based OS subsystem: users run asynchronous batch-file processes, which can have multiple windows; the subsystem manages processes and window lifecycle, while BatchWindows renders themed graphics. BXF supplies expanded functions and an API, and systemb is the default desktop environment. The README also documents shutdown/reboot, resource-pack themes and sprites, and keyboard layouts. No source excerpts were provided, so edges below are limited to relationships stated in the README; implementation details and call ownership cannot be verified.

Main entry points: [`C/Shivtanium/sstoskrnl.bat`](https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/sstoskrnl.bat) (Process manager), [`C/Shivtanium/resourcepacks`](https://github.com/shivter14/shivtanium/tree/main/C/Shivtanium/resourcepacks) (Resource packs), [`C/Shivtanium/main.bat`](https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/main.bat) (Shivtanium subsystem), [`C/Shivtanium/core/dwm.bxf`](https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/core/dwm.bxf) (BatchWindows DWM)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["OS Runtime"]
  node_os["Shivtanium subsystem<br/>[main.bat]"]
  node_processes["Process manager<br/>[sstoskrnl.bat]"]
  node_pipe["File pipe streams<br/>[preparePipe.bat]"]
  node_lifecycle["Window lifecycle<br/>[sstoskrnl.bat]"]
  node_power["Shutdown and reboot<br/>[sys.bxf]"]
end

subgraph group_windows["Windowing"]
  node_batchwindows["BatchWindows DWM<br/>[dwm.bxf]"]
  node_themes["Theme rendering"]
end

subgraph group_desktop["Desktop Environment"]
  node_systemb["systemb desktop"]
  node_applications["Batch applications"]
end

subgraph group_resources["User Resources"]
  node_resourcepacks["Resource packs"]
  node_sprites["Sprite assets"]
  node_keyboard["Keyboard layouts<br/>[keyboard_init.bat]"]
end

subgraph group_extensions["Extensions"]
  node_bxf["BXF compiler and API<br/>[bxf.bat]"]
  node_batchfiles["Async batch files"]
end

node_user(("User"))

node_user -->|"runs processes"| node_processes
node_processes -->|"runs asynchronously"| node_batchfiles
node_processes -->|"communicates via"| node_pipe
node_processes -->|"manages windows"| node_lifecycle
node_os -->|"handles shutdown"| node_power
node_os -->|"provides API"| node_bxf
node_batchwindows -->|"renders with"| node_themes
node_resourcepacks -->|"customizes"| node_themes
node_systemb -->|"uses window manager"| node_batchwindows
node_user -->|"types with layouts"| node_keyboard
node_resourcepacks -->|"contains layouts"| node_keyboard
node_resourcepacks -->|"includes sprites"| node_sprites

click node_os "https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/main.bat"
click node_processes "https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/sstoskrnl.bat"
click node_pipe "https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/preparePipe.bat"
click node_lifecycle "https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/sstoskrnl.bat"
click node_power "https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/core/sys.bxf"
click node_batchwindows "https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/core/dwm.bxf"
click node_themes "https://github.com/shivter14/shivtanium/tree/main/C/Shivtanium/resourcepacks/init/themes"
click node_resourcepacks "https://github.com/shivter14/shivtanium/tree/main/C/Shivtanium/resourcepacks"
click node_sprites "https://github.com/shivter14/shivtanium/tree/main/C/Shivtanium/resourcepacks/init/sprites"
click node_keyboard "https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/resourcepacks/init/keyboard_init.bat"
click node_systemb "https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/systemb/systemb-desktop.bxf"
click node_applications "https://github.com/shivter14/shivtanium/tree/main/C/Shivtanium/programs"
click node_bxf "https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/core/bxf.bat"
click node_batchfiles "https://github.com/shivter14/shivtanium/tree/main/C/Shivtanium"

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_os,node_processes,node_pipe,node_lifecycle,node_power,node_user toneBlue
class node_batchwindows,node_themes toneAmber
class node_systemb,node_applications toneMint
class node_resourcepacks,node_sprites,node_keyboard toneRose
class node_bxf,node_batchfiles toneIndigo
```

## Components

### OS Runtime

- [Shivtanium subsystem](https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/main.bat): `C/Shivtanium/main.bat`
- [Process manager](https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/sstoskrnl.bat): `C/Shivtanium/sstoskrnl.bat`
- [File pipe streams](https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/preparePipe.bat): `C/Shivtanium/preparePipe.bat`
- [Window lifecycle](https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/sstoskrnl.bat): `C/Shivtanium/sstoskrnl.bat`
- [Shutdown and reboot](https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/core/sys.bxf): `C/Shivtanium/core/sys.bxf`

### Windowing

- [BatchWindows DWM](https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/core/dwm.bxf): `C/Shivtanium/core/dwm.bxf`
- [Theme rendering](https://github.com/shivter14/shivtanium/tree/main/C/Shivtanium/resourcepacks/init/themes): `C/Shivtanium/resourcepacks/init/themes`

### Desktop Environment

- [systemb desktop](https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/systemb/systemb-desktop.bxf): `C/Shivtanium/systemb/systemb-desktop.bxf`
- [Batch applications](https://github.com/shivter14/shivtanium/tree/main/C/Shivtanium/programs): `C/Shivtanium/programs`

### User Resources

- [Resource packs](https://github.com/shivter14/shivtanium/tree/main/C/Shivtanium/resourcepacks): `C/Shivtanium/resourcepacks`
- [Sprite assets](https://github.com/shivter14/shivtanium/tree/main/C/Shivtanium/resourcepacks/init/sprites): `C/Shivtanium/resourcepacks/init/sprites`
- [Keyboard layouts](https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/resourcepacks/init/keyboard_init.bat): `C/Shivtanium/resourcepacks/init/keyboard_init.bat`

### Extensions

- [BXF compiler and API](https://github.com/shivter14/shivtanium/blob/main/C/Shivtanium/core/bxf.bat): `C/Shivtanium/core/bxf.bat`
- [Async batch files](https://github.com/shivter14/shivtanium/tree/main/C/Shivtanium): `C/Shivtanium`

### Other components

- **User**

## Connections

- User → Process manager: runs processes (evidence: `README.md`)
- Process manager → Async batch files: runs asynchronously (evidence: `README.md`)
- Process manager → File pipe streams: communicates via (evidence: `README.md`)
- Process manager → Window lifecycle: manages windows (evidence: `README.md`)
- Shivtanium subsystem → Shutdown and reboot: handles shutdown (evidence: `README.md`)
- Shivtanium subsystem → BXF compiler and API: provides API (evidence: `README.md`)
- BatchWindows DWM → Theme rendering: renders with (evidence: `README.md`)
- Resource packs → Theme rendering: customizes (evidence: `README.md`)
- systemb desktop → BatchWindows DWM: uses window manager (evidence: `README.md`)
- User → Keyboard layouts: types with layouts (evidence: `README.md`)
- Resource packs → Keyboard layouts: contains layouts (evidence: `README.md`)
- Resource packs → Sprite assets: includes sprites (evidence: `README.md`)
