Skip to content

hhuOS/hhuOS

Repository files navigation

hhuOS

Introduction

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!

Compiling

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

Usage

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.

Notes

Assets for the mouse demo haven been taken from Icons8.

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

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

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

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

Music for the SoundBlaster demo has been taken from Bensound:

  • Ukulele license code: 3M7PXYPYNOTSIGNQ