BoredOS Logo

A modern x86_64 hobbyist operating system built from the ground up.

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) ![Platform: x86_64](https://img.shields.io/badge/Platform-x86_64-lightgrey) ![Status: Active](https://img.shields.io/badge/Status-Active-brightgreen) ![GitHub all releases](https://img.shields.io/github/downloads/boreddevnl/BoredOS/total?color=brightgreen)
[Docs](docs/README.md) · [Build & Run](docs/build/usage.md) · [AppDev SDK](docs/appdev/sdk_reference.md) · [Discord](https://discord.gg/J2BxWaFAgY) · [Support](https://buymeacoffee.com/boreddevhq)
--- ![Screenshot](branding/screenshot.jpg) > [!NOTE] > The screenshot above may represent a previous build and is subject to change as the UI evolves. --- ## Features ### Kernel and Architecture - **Long Mode Architecture** — Native x86_64 implementation utilizing 64-bit address space and registers - **Symmetric Multi-Processing** — Scalable multi-core support with IPI-based scheduling and synchronization - **Advanced Memory Management** — Custom slab allocator with object pooling and efficient physical/virtual page mapping - **Hybrid VFS Layer** — Unified filesystem interface supporting FAT32, TAR, ProcFS, and SysFS - **Preemptive Multitasking** — Prioritized process scheduling with full context isolation - **Hardware Abstraction** — Comprehensive driver support for PCI, AHCI, PS/2, and ACPI ### Graphical Desktop Environment - **BoredWM** — High-performance window manager featuring window stacking, focus management, and drag-and-drop interactions - **Typography Engine** — Integrated font manager with TrueType (TTF) support and efficient glyph caching - **Rich Media Subsystem** — Native hardware-independent decoding for PNG, JPEG, GIF, BMP, and TGA formats - **LibWidget Toolkit** — Native UI component library for rapid application development ### Networking Stack - **TCP/IP Integration** — Full lwIP-based network stack featuring DHCP, DNS, and Berkeley-style sockets - **Network Services** — Integrated support for basic web browsing and real-time network telemetry ### Application Ecosystem | Category | Applications | |----------|--------------| | Productivity | Text Editor, Markdown Viewer, BoredWord Processor, Web Browser, Calculator | | Development | TCC (Tiny C Compiler), Lua| | System | Explorer (File Manager), Task Manager, System Monitor, Graphing Utility | | Games | doomgeneric, Minesweeper, 2048, Snake | --- ## 📚 Documentation | Guide | Description | |-------|-------------| | [Documentation Index](docs/README.md) | Start here! | | [Architecture Overview](docs/architecture/README.md) | Deep dive into the kernel | | [Building and Running](docs/build/usage.md) | Set up your build environment | | [AppDev SDK](docs/appdev/custom_apps.md) | Build your own apps for BoredOS | --- ## Contributors
BoredOS Logo

A modern x86_64 hobbyist operating system built from the ground up.

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) ![Platform: x86_64](https://img.shields.io/badge/Platform-x86_64-lightgrey) ![Status: Active](https://img.shields.io/badge/Status-Active-brightgreen) ![GitHub all releases](https://img.shields.io/github/downloads/boreddevnl/BoredOS/total?color=brightgreen)
[Docs](docs/README.md) · [Build & Run](docs/build/usage.md) · [AppDev SDK](docs/appdev/sdk_reference.md) · [Discord](https://discord.gg/J2BxWaFAgY) · [Support](https://buymeacoffee.com/boreddevhq)
--- ![Screenshot](branding/screenshot.jpg) > [!NOTE] > The screenshot above may represent a previous build and is subject to change as the UI evolves. --- ## Features ### Kernel and Architecture - **Long Mode Architecture** — Native x86_64 implementation utilizing 64-bit address space and registers - **Symmetric Multi-Processing** — Scalable multi-core support with IPI-based scheduling and synchronization - **Advanced Memory Management** — Custom slab allocator with object pooling and efficient physical/virtual page mapping - **Hybrid VFS Layer** — Unified filesystem interface supporting FAT32, TAR, ProcFS, and SysFS - **Preemptive Multitasking** — Prioritized process scheduling with full context isolation - **Hardware Abstraction** — Comprehensive driver support for PCI, AHCI, PS/2, and ACPI ### Graphical Desktop Environment - **BoredWM** — High-performance window manager featuring window stacking, focus management, and drag-and-drop interactions - **Typography Engine** — Integrated font manager with TrueType (TTF) support and efficient glyph caching - **Rich Media Subsystem** — Native hardware-independent decoding for PNG, JPEG, GIF, BMP, and TGA formats - **LibWidget Toolkit** — Native UI component library for rapid application development ### Networking Stack - **TCP/IP Integration** — Full lwIP-based network stack featuring DHCP, DNS, and Berkeley-style sockets - **Network Services** — Integrated support for basic web browsing and real-time network telemetry ### Application Ecosystem | Category | Applications | |----------|--------------| | Productivity | Text Editor, Markdown Viewer, BoredWord Processor, Web Browser, Calculator | | Development | TCC (Tiny C Compiler), Lua| | System | Explorer (File Manager), Task Manager, System Monitor, Graphing Utility | | Games | doomgeneric, Minesweeper, 2048, Snake | --- ## 📚 Documentation | Guide | Description | |-------|-------------| | [Documentation Index](docs/README.md) | Start here! | | [Architecture Overview](docs/architecture/README.md) | Deep dive into the kernel | | [Building and Running](docs/build/usage.md) | Set up your build environment | | [AppDev SDK](docs/appdev/custom_apps.md) | Build your own apps for BoredOS | --- ## Contributors

BoredDevNL
Creator & Lead Maintainer
Lluciocc
Maintainer
Mellurboo
Contributor
Artemix1508
Artwork

Zeyadhost
Contributor
Naplon74
Artwork
pixelyblah
Artwork
qwroffc
Artwork
--- ## ☕ Support the Journey If you find BoredOS interesting or useful, consider fueling development with a coffee! Buy Me A Coffee --- ## History **BoredOS** is the successor to **[BrewKernel](https://github.com/boreddevnl/brewkernel)**, a project started in 2023. BrewKernel served as the foundational learning ground but has since been officially deprecated and archived — it no longer receives updates, bug fixes, or pull request reviews. BoredOS is a complete architectural reboot, applying years of lessons learned to build a cleaner, more modular, and more capable system. > [!IMPORTANT] > Please direct all issues, discussions, and contributions to this repository. Legacy BrewKernel code is preserved for historical purposes only and is not compatible with BoredOS. --- ## License **Copyright (C) 2023–2026 boreddevnl** Distributed under the **GNU General Public License v3**. See [`LICENSE`](LICENSE) for details. > [!IMPORTANT] > You must retain all copyright headers and include the original attribution in any redistributions or derivative works. See the [`NOTICE`](NOTICE) file for more details. --- ## ☕ Support the Journey If you find BoredOS interesting or useful, consider fueling development with a coffee! Buy Me A Coffee --- ## History **BoredOS** is the successor to **[BrewKernel](https://github.com/boreddevnl/brewkernel)**, a project started in 2023. BrewKernel served as the foundational learning ground but has since been officially deprecated and archived — it no longer receives updates, bug fixes, or pull request reviews. BoredOS is a complete architectural reboot, applying years of lessons learned to build a cleaner, more modular, and more capable system. > [!IMPORTANT] > Please direct all issues, discussions, and contributions to this repository. Legacy BrewKernel code is preserved for historical purposes only and is not compatible with BoredOS. --- ## License **Copyright (C) 2023–2026 boreddevnl** Distributed under the **GNU General Public License v3**. See [`LICENSE`](LICENSE) for details. > [!IMPORTANT] > You must retain all copyright headers and include the original attribution in any redistributions or derivative works. See the [`NOTICE`](NOTICE) file for more details.