How andrisgauracs/bevel-os works
Bevel OS is an ESP32-S3 graphical desktop. Its runtime starts the display, storage, window manager, loadable-app support, and networking, then enters the desktop event loop. Users work through built-in programs or launch separate ELF apps from the drive; files, network browsing, and windowed interaction are distinct product stages. The graph preserves the documented desktop, input, display, storage, networking, and app capabilities. Some subsystem paths are supported by the tree and README rather than inspected implementation; those links are omitted where call ownership is not established.
Main entry points: apps.c Built-in app registry · main.c Boot and GUI task · fsutil.h Filesystem helpers · storage.c Flash FAT drive
Components 26
Desktop and UI
- Boot and GUI task
main/main.c - Window manager
main/wm.c - Widget toolkit
main/ui.c - Damage compositor
main/comp.c - Graphics primitives
main/gfx.c
Applications
- Built-in app registry
main/apps.c - File manager
main/app_files.c - Text editor
main/app_editor.c - Picture viewer
main/app_misc.c - System utilities
main/app_misc.c - Terminal
main/shell.c - Text web browser
main/app_browser.c - Network settings
main/app_net.c - ELF app loader
main/app_loader.c - Doom app
apps/doom/doom_bevel.c - Snake app
apps/Snake.c - App API
apps/bevel.h
Device platform
- Input routing
main/input.c - USB host input
main/usb_input.c - VGA scan-out
main/vga.c
Storage and network
- Filesystem helpers
main/fsutil.h - Flash FAT drive
main/storage.c - Wi-Fi networking
main/net.c
External systems
- Wi-Fi service
- On-device drive
Other components
- Desktop user
Connections 30
- Desktop user → Window manager: operates
- Boot and GUI task → VGA scan-out: initializes
main/main.c - Boot and GUI task → Input routing: initializes
main/main.c - Boot and GUI task → Flash FAT drive: mounts
main/main.c - Boot and GUI task → Window manager: starts
main/main.c - Boot and GUI task → ELF app loader: starts
main/main.c - Boot and GUI task → Wi-Fi networking: starts
main/main.c - Input routing → USB host input: receives input
- Window manager → Damage compositor: invalidates regions
main/wm.c - Damage compositor → Graphics primitives: paints strips
- Damage compositor → VGA scan-out: flushes framebuffer
- Built-in app registry → File manager: launches
main/apps.c - Built-in app registry → Text editor: launches
main/apps.c - Built-in app registry → Text web browser: launches
main/apps.c - Built-in app registry → Network settings: launches
main/apps.c - Built-in app registry → Terminal: launches
main/apps.c - Built-in app registry → System utilities: launches
main/apps.c - Built-in app registry → Picture viewer: launches
main/apps.c - File manager → Filesystem helpers: uses file helpers
main/app_files.c - Text editor → Filesystem helpers: uses file helpers
main/app_editor.c - Terminal → Filesystem helpers: uses file helpers
main/shell.c - Text web browser → Wi-Fi networking: uses networking
main/app_browser.c - Network settings → Wi-Fi networking: configures network
- Filesystem helpers → Flash FAT drive: accesses drive
- Flash FAT drive → On-device drive: mounts
main/storage.c - Wi-Fi networking → Wi-Fi service: uses
- ELF app loader → Flash FAT drive: loads drive apps
- ELF app loader → App API: provides interface
main/app_loader.c - Doom app → App API: calls app API
apps/doom/doom_bevel.c - Snake app → App API: uses app API
apps/Snake.c