MaxOS

Max OS

A 64bit hobby operating system written in C++
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Acknowledgments

About The Project

!-- CURRENTLY IMPLEMENTING 64BIT SUPPORT, OS IS IN A BROKEN STATE --!

Max OS is a hobby operating system developed for the 64bit platform using C++ and Assembly. The project is currently in the early stages of development and is not yet ready for use. The project is being developed as a learning experience and is not intended to be used as a production operating system.

Max OS supports device drivers, memory management, multitasking, a GUI, and more. The project is being developed with the goal of being able to run on real hardware, however, it is currently only able to run on a virtual machine.

(back to top)

Getting Started

This is how to build the Max OS operating system from source. (Alternatively, you can download the latest built kernel from the workflow artifacts)

Prerequisites

This is the list of required packages to build the operating system from source. (Note the build scripts should install these automatically)

• build-essential
• bison
• flex
• libgmp3-dev
• libmpc-dev
• libmpfr-dev
• texinfo
• libisl-dev
• cmake

  sudo apt update
  sudo apt install -y build-essential bison flex libgmp3-dev libmpc-dev libmpfr-dev texinfo libisl-dev cmake

Note: If you want to run the operating system in a virtual machine, you will need to install QEMU. (If in WSL the script will look for a Windows installation of QEMU)

Installation

• Upon first build follow steps 1-5
• If you change the file structure (e.g. add a new file) follow steps 3-5
• If you running on a new boot (eg you rebooted your computer) follow steps 4-5
• If you only change a file follow step 5

1. Clone the repo

   git clone https://github.com/maxtyson123/MaxOS.git
   cd MaxOS

2. Create the cross compiler (This will take a while)

   cd toolchain
   ./make_cross_compiler.sh
   cd ../

3. Generate makefiles

   cd cmake-build
   cmake .. -DCMAKE_TOOLCHAIN_FILE=toolchain/CMakeToolchain.txt

4. Clean the build directory

   make clean

5. Build the operating system & Run it in QEMU

   make install image run

(back to top)

Usage

No user usage so far (userland will be added in the future)

Boot Console

GUI

Roadmap

• Bootloader
• GDT
• IDT
• Interrupts
• Keyboard & Mouse
• PCI
• ATA
• VESA
• Memory Management
• Multitasking
• GUI
• Window Manager
• Paging
• Userspace
• IPC
• VFS
• Loading ELF
• CLI
• Porting Libc
• Userland GUI
• DOOM Port?

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the BSD 3-Clause License. See LICENSE for more information.

(back to top)

Acknowledgments

• OSDev.org
• WYOOS
• OSDev Notes
• OSDev Subreddit
• Duck OS
• Dream OS

(back to top)