abdulg59 / hhuOS

hhuOS - A small operating system

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 init
git submodule update
./build.sh
./run.sh

See the wiki for more details.

Notes

Assets for the dino game have been taken unaltered 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