mirror of
https://github.com/BoredDevNL/BoredOS.git
synced 2026-05-13 01:48:42 +00:00
268 lines
10 KiB
Markdown
268 lines
10 KiB
Markdown
<div align="center">
|
||
<img src="branding/bOS_full_gradient_cropped.png" alt="BoredOS Logo" width="450" />
|
||
|
||
<h3>A modern x86_64 hobbyist operating system built from the ground up.</h3>
|
||
|
||
[](https://www.gnu.org/licenses/gpl-3.0)
|
||
|
||
|
||
|
||
|
||
<br />
|
||
|
||
[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)
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
|
||
|
||
> [!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
|
||
|
||
<div align="center">
|
||
<img src="branding/bOS_full_gradient_cropped.png" alt="BoredOS Logo" width="450" />
|
||
|
||
<h3>A modern x86_64 hobbyist operating system built from the ground up.</h3>
|
||
|
||
[](https://www.gnu.org/licenses/gpl-3.0)
|
||
|
||
|
||
|
||
|
||
<br />
|
||
|
||
[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)
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
|
||
|
||
> [!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
|
||
|
||
<table>
|
||
<tr>
|
||
<td align="center">
|
||
<a href="https://github.com/boreddevnl">
|
||
<img src="https://github.com/boreddevnl.png?size=80" width="60" /><br />
|
||
<sub><b>BoredDevNL</b></sub>
|
||
</a><br />
|
||
Creator & Lead Maintainer
|
||
</td>
|
||
<td align="center">
|
||
<a href="https://github.com/Lluciocc">
|
||
<img src="https://github.com/Lluciocc.png?size=80" width="60" /><br />
|
||
<sub><b>Lluciocc</b></sub>
|
||
</a><br />
|
||
Maintainer
|
||
</td>
|
||
<td align="center">
|
||
<a href="https://github.com/Mellurboo">
|
||
<img src="https://github.com/Mellurboo.png?size=80" width="60" /><br />
|
||
<sub><b>Mellurboo</b></sub>
|
||
</a><br />
|
||
Contributor
|
||
</td>
|
||
<td align="center">
|
||
<a href="https://github.com/Artemix1508">
|
||
<img src="https://github.com/Artemix1508.png?size=80" width="60" /><br />
|
||
<sub><b>Artemix1508</b></sub>
|
||
</a><br />
|
||
Artwork
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center">
|
||
<a href="https://github.com/zeyadhost">
|
||
<img src="https://github.com/zeyadhost.png?size=80" width="60" /><br />
|
||
<sub><b>Zeyadhost</b></sub>
|
||
</a><br />
|
||
Contributor
|
||
</td>
|
||
<td align="center">
|
||
<a href="https://github.com/naplon74">
|
||
<img src="https://github.com/naplon74.png?size=80" width="60" /><br />
|
||
<sub><b>Naplon74</b></sub>
|
||
</a><br />
|
||
Artwork
|
||
</td>
|
||
<td align="center">
|
||
<a href="https://github.com/pixelyblah">
|
||
<img src="https://github.com/pixelyblah.png?size=80" width="60" /><br />
|
||
<sub><b>pixelyblah</b></sub>
|
||
</a><br />
|
||
Artwork
|
||
</td>
|
||
<td align="center">
|
||
<a href="https://github.com/qwroffc">
|
||
<img src="https://github.com/qwroffc.png?size=80" width="60" /><br />
|
||
<sub><b>qwroffc</b></sub>
|
||
</a><br />
|
||
Artwork
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
---
|
||
|
||
## ☕ Support the Journey
|
||
|
||
If you find BoredOS interesting or useful, consider fueling development with a coffee!
|
||
|
||
<a href="https://buymeacoffee.com/boreddevhq" target="_blank">
|
||
<img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="50" style="border-radius: 8px;" />
|
||
</a>
|
||
|
||
---
|
||
|
||
## 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!
|
||
|
||
<a href="https://buymeacoffee.com/boreddevhq" target="_blank">
|
||
<img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="50" style="border-radius: 8px;" />
|
||
</a>
|
||
|
||
---
|
||
|
||
## 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.
|