https://github.com/woidptr/void-os
An experimental os written in c23
https://github.com/woidptr/void-os
c23 operating-system os
Last synced: 28 days ago
JSON representation
An experimental os written in c23
- Host: GitHub
- URL: https://github.com/woidptr/void-os
- Owner: woidptr
- License: gpl-3.0
- Created: 2026-03-17T16:01:50.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-08T19:54:08.000Z (about 1 month ago)
- Last Synced: 2026-05-08T21:36:40.416Z (about 1 month ago)
- Topics: c23, operating-system, os
- Language: C
- Homepage:
- Size: 925 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# void-os
Operating system made with c23, using the limine bootloader.
## Requirements
To build and emulate the OS, you will need a Unix-like environment (Linux, macOS, or WSL) with the following tools installed:
### Core Build Tools
* **`make`** or `shell`: GNU Make or shell for launching the build script.
* **`python3`**: For the build script.
* **`clang`**: The cross-compiler used to build the kernel, without linking to host OS or standard library.
* **`xorriso`**: Required to pack the compiled kernel and Limine bootloader into a bootable `.iso` image.
### Emulation
* **`qemu-system-x86_64`**: The QEMU emulator used to test the OS without flashing it to physical hardware.
## Build Interfaces
This project uses a unified Python-based build engine. For convenience, there are two identical interfaces to the engine depending on your preferred workflow. Both scripts accept the same arguments and provide full help documentation.
### Unified Command Interface
You can interact with the build system through either make or the shell wrapper. Choose the one that fits your muscle memory:
**Using make:**
```bash
make --help
```
**Using the shell script:**
```bash
./build.sh --help
```