Welcome to hhuOS, a small operating system written in C++ and Assembler for the x86-architecture. The main purpose of this project is to show how different aspects of operating systems theory can be implemented and linked together. The system is not aimed to be a full-featured operating system for daily use.

This is a project by the Operating Systems group at the Heinrich Heine University Düsseldorf.

Check out our wiki!

GCC 7 and CMake 3.14 or newer versions of GCC and CMake are required to compile hhuOS.
Before the kernel can be compiled, some packages must be installed. To install them, you can run the following command (on Ubuntu 20.04):

sudo apt install cmake make nasm gcc-multilib g++-multilib grub-pc-bin grub-efi-ia32-bin dosfstools mtools xorriso zstd unzip wget

To test hhuOS quickly in QEMU, you can issue the following commands.

git clone https://github.com/hhuOS/hhuOS.git
cd hhuOS/
git submodule initialize
git submodule update
./build.sh
./run.sh

See the wiki for more details.

Assets for the mouse demo haven been taken from Icons8.

Assets for the dino game have been taken from itch.io:

• Dino Characters by @ScissorMarks (CC BY 4.0)
• Dino Family by DemChing (CC BY 4.0)
• Pixel Adventure by Pixel Frog (CC0 1.0)
• Retro Cloud Tileset by ohnoponogames

Assets for the bug defender game have been taken from itch.io:

• Lunar Battle Pack by MattWalkden (CC0 1.0)
• Pixel Heart Animation by Nicole Marie T

3D-demo assets haven been taken from itch.io:

• M1 Tank by Alstra Infinite (CC BY 4.0)
• Shark by Alstra Infinite (CC BY 4.0)
• Plane by Alstra Infinite (CC BY 4.0)
• Coffee Maker by Alstra Infinite (CC BY 4.0)

Assets for the battlespace game have been taken from itch.io:

• Lowpoly - 3D Space Assets Pack by ejgarner118

Music for the SoundBlaster demo has been taken from Bensound:

• Ukulele license code: 3M7PXYPYNOTSIGNQ