# talonfloof/zorroos architecture

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

- Interactive diagram: https://gitdiagram.com/talonfloof/zorroos
- Repository: https://github.com/talonfloof/zorroos

## Overview

zorroOS is a hobby x86_64 operating system; the supplied tree exposes its userspace services and libraries, not the kernel. A principal visible interaction is Raven managing windows and input while client applications use its UI and widget library. Raven also composites framebuffer content and loads graphical assets. The README gives little detail beyond the OS identity, so the graph focuses on evidenced userspace behavior and listed runtime modules; several library and application relationships remain unconnected because their source was not shown.

Main entry points: [`userspace/services/raven/main.c`](https://github.com/talonfloof/zorroos/blob/main/userspace/services/raven/main.c) (Raven compositor), [`lib/libzorro/Filesystem/MQueue.c`](https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/Filesystem/MQueue.c) (Message queues), [`lib/libzorro/Filesystem/Filesystem.c`](https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/Filesystem/Filesystem.c) (Filesystem API), [`lib/libraven/Raven/UI.c`](https://github.com/talonfloof/zorroos/blob/main/lib/libraven/Raven/UI.c) (Window UI runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_services["Userspace services"]
  node_apps["User applications"]
  node_init["Init service<br/>[main.c]"]
end

subgraph group_raven["Raven window system"]
  node_raven_service["Raven compositor<br/>[main.c]"]
  node_keyboard["Keyboard input<br/>[kbd.c]"]
  node_mouse["Mouse input<br/>[mouse.c]"]
end

subgraph group_client["Raven client UI"]
  node_raven_client["Raven client API<br/>[Raven.c]"]
  node_ui["Window UI runtime<br/>[UI.c]"]
  node_widgets["UI widgets"]
end

subgraph group_runtime["System libraries"]
  node_graphics["Graphics primitives<br/>[Graphics.c]"]
  node_image["Image handling<br/>[Image.c]"]
  node_qoi["QOI codec<br/>[QOI.h]"]
  node_blur["Stack blur<br/>[StackBlur.c]"]
  node_filesystem["Filesystem API<br/>[Filesystem.c]"]
  node_queues["Message queues<br/>[MQueue.c]"]
  node_syscalls["System calls<br/>[Syscall.c]"]
  node_memory["Memory allocator<br/>[Alloc.c]"]
  node_strings["String utilities<br/>[String.c]"]
  node_threads["Thread API<br/>[Thread.c]"]
  node_shared_memory["Shared memory<br/>[SharedMemory.c]"]
end

node_user(("Computer user"))
node_framebuffer[("Framebuffer device")]

node_user -.->|"uses"| node_apps
node_apps -.->|"uses"| node_raven_client
node_ui -->|"calls"| node_raven_client
node_ui -->|"uses"| node_widgets
node_raven_service -->|"starts thread"| node_keyboard
node_raven_service -->|"starts thread"| node_mouse
node_raven_service -->|"receives and sends"| node_queues
node_raven_service -->|"opens framebuffer"| node_filesystem
node_raven_service -->|"reads and draws"| node_framebuffer
node_raven_service -->|"loads icon pack"| node_graphics
node_raven_service -->|"loads QOI assets"| node_qoi
node_raven_service -->|"blurs composited regions"| node_blur
node_raven_service -->|"creates input threads"| node_threads
node_raven_service -->|"maps window buffers"| node_shared_memory
node_qoi -->|"writes via"| node_filesystem
node_filesystem -->|"uses"| node_syscalls
node_queues -->|"uses"| node_filesystem
node_queues -->|"allocates with"| node_memory
node_queues -->|"uses"| node_strings

click node_apps "https://github.com/talonfloof/zorroos/tree/main/userspace/apps"
click node_init "https://github.com/talonfloof/zorroos/blob/main/userspace/services/init/main.c"
click node_raven_service "https://github.com/talonfloof/zorroos/blob/main/userspace/services/raven/main.c"
click node_keyboard "https://github.com/talonfloof/zorroos/blob/main/userspace/services/raven/kbd.c"
click node_mouse "https://github.com/talonfloof/zorroos/blob/main/userspace/services/raven/mouse.c"
click node_raven_client "https://github.com/talonfloof/zorroos/blob/main/lib/libraven/Raven/Raven.c"
click node_ui "https://github.com/talonfloof/zorroos/blob/main/lib/libraven/Raven/UI.c"
click node_widgets "https://github.com/talonfloof/zorroos/tree/main/lib/libraven/Raven/Widgets"
click node_graphics "https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/Media/Graphics.c"
click node_image "https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/Media/Image.c"
click node_qoi "https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/Media/QOI.h"
click node_blur "https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/Media/StackBlur.c"
click node_filesystem "https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/Filesystem/Filesystem.c"
click node_queues "https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/Filesystem/MQueue.c"
click node_syscalls "https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/System/Syscall.c"
click node_memory "https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/Common/Alloc.c"
click node_strings "https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/Common/String.c"
click node_threads "https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/System/Thread.c"
click node_shared_memory "https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/System/SharedMemory.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_apps,node_init,node_user toneBlue
class node_raven_service,node_keyboard,node_mouse,node_framebuffer toneAmber
class node_raven_client,node_ui,node_widgets toneMint
class node_graphics,node_image,node_qoi,node_blur,node_filesystem,node_queues,node_syscalls,node_memory,node_strings,node_threads,node_shared_memory toneRose
```

## Components

### Userspace services

- [User applications](https://github.com/talonfloof/zorroos/tree/main/userspace/apps): `userspace/apps`
- [Init service](https://github.com/talonfloof/zorroos/blob/main/userspace/services/init/main.c): `userspace/services/init/main.c`

### Raven window system

- [Raven compositor](https://github.com/talonfloof/zorroos/blob/main/userspace/services/raven/main.c): `userspace/services/raven/main.c`
- [Keyboard input](https://github.com/talonfloof/zorroos/blob/main/userspace/services/raven/kbd.c): `userspace/services/raven/kbd.c`
- [Mouse input](https://github.com/talonfloof/zorroos/blob/main/userspace/services/raven/mouse.c): `userspace/services/raven/mouse.c`

### Raven client UI

- [Raven client API](https://github.com/talonfloof/zorroos/blob/main/lib/libraven/Raven/Raven.c): `lib/libraven/Raven/Raven.c`
- [Window UI runtime](https://github.com/talonfloof/zorroos/blob/main/lib/libraven/Raven/UI.c): `lib/libraven/Raven/UI.c`
- [UI widgets](https://github.com/talonfloof/zorroos/tree/main/lib/libraven/Raven/Widgets): `lib/libraven/Raven/Widgets`

### System libraries

- [Graphics primitives](https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/Media/Graphics.c): `lib/libzorro/Media/Graphics.c`
- [Image handling](https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/Media/Image.c): `lib/libzorro/Media/Image.c`
- [QOI codec](https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/Media/QOI.h): `lib/libzorro/Media/QOI.h`
- [Stack blur](https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/Media/StackBlur.c): `lib/libzorro/Media/StackBlur.c`
- [Filesystem API](https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/Filesystem/Filesystem.c): `lib/libzorro/Filesystem/Filesystem.c`
- [Message queues](https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/Filesystem/MQueue.c): `lib/libzorro/Filesystem/MQueue.c`
- [System calls](https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/System/Syscall.c): `lib/libzorro/System/Syscall.c`
- [Memory allocator](https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/Common/Alloc.c): `lib/libzorro/Common/Alloc.c`
- [String utilities](https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/Common/String.c): `lib/libzorro/Common/String.c`
- [Thread API](https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/System/Thread.c): `lib/libzorro/System/Thread.c`
- [Shared memory](https://github.com/talonfloof/zorroos/blob/main/lib/libzorro/System/SharedMemory.c): `lib/libzorro/System/SharedMemory.c`

### Other components

- **Computer user**
- **Framebuffer device**

## Connections

- Computer user → User applications: uses
- User applications → Raven client API: uses
- Window UI runtime → Raven client API: calls (evidence: `lib/libraven/Raven/UI.c`)
- Window UI runtime → UI widgets: uses (evidence: `lib/libraven/Raven/UI.c`)
- Raven compositor → Keyboard input: starts thread (evidence: `userspace/services/raven/main.c`)
- Raven compositor → Mouse input: starts thread (evidence: `userspace/services/raven/main.c`)
- Raven compositor → Message queues: receives and sends (evidence: `userspace/services/raven/main.c`)
- Raven compositor → Filesystem API: opens framebuffer (evidence: `userspace/services/raven/main.c`)
- Raven compositor → Framebuffer device: reads and draws (evidence: `userspace/services/raven/main.c`)
- Raven compositor → Graphics primitives: loads icon pack (evidence: `userspace/services/raven/main.c`)
- Raven compositor → QOI codec: loads QOI assets (evidence: `userspace/services/raven/main.c`)
- Raven compositor → Stack blur: blurs composited regions (evidence: `userspace/services/raven/main.c`)
- Raven compositor → Thread API: creates input threads (evidence: `userspace/services/raven/main.c`)
- Raven compositor → Shared memory: maps window buffers (evidence: `userspace/services/raven/main.c`)
- QOI codec → Filesystem API: writes via (evidence: `lib/libzorro/Media/QOI.h`)
- Filesystem API → System calls: uses
- Message queues → Filesystem API: uses (evidence: `lib/libzorro/Filesystem/MQueue.c`)
- Message queues → Memory allocator: allocates with (evidence: `lib/libzorro/Filesystem/MQueue.c`)
- Message queues → String utilities: uses (evidence: `lib/libzorro/Filesystem/MQueue.c`)
