NoirOS

Noir OS docs in retro terminal mode.

“An idiot admires complexity, a genius admires simplicity”

“But I’m an idiot who admires simplicity”

NoirOS is a simple, educational operating system project. It is designed to help users understand the basics of OS development, including bootloading, kernel design, and basic user applications.

Demo Video

Tip: The video is pulled directly from the GitHub repository to avoid static path 404s.

Features

• Custom kernel written in C and Assembly
• Persistent shell command panel
• Basic file system support
• Text editor
• Snake, Pong, Dodge, and Catch games
• Mouse and keyboard input handling
• VGA text mode UI
• Boot splash loader with Noir OS logo

Getting Started

Building NoirOS

To build NoirOS, you will need a cross-compiler for i386 and the following tools:

• make
• nasm
• qemu (for emulation)

Clone the repository and run:

make

Running in QEMU

After building, you can run NoirOS in QEMU:

make run

Project Structure

• src/ — Source code for the kernel and applications
• include/ — Header files
• boot/ — Bootloader files
• build/ — Build output
• iso/ — ISO image structure

Documentation

• Playground - Try NoirOS commands in your browser.
• API Reference — Public interfaces and module map.

  Module docs

• Input
• Editor
• Filesystem
• Memory/Paging
• Snake Game
• Kernel
• Mouse
• Utilities
• VGA / Drawing

License

NoirOS is released under the MIT License. See the License file for details.

Contributing

Contributions are welcome! Please open issues or pull requests to help improve NoirOS.