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

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.

This GitHub repository contains the source code for the operating system, as well as the build scripts required to build the operating system from source. The repository also contains the latest built kernel, which can be downloaded from the workflow artifacts. To ensure a cleaner git history, each feature/change is done in a separate branch and then merged into the main branch once working. To see the history of each feature press on the pull request number. If you are intrested in the active developement find the latest branch Here.

(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)

Currently Max OS can only be built on a linux machine, but does support WSL. In the future I do plan to port the build system to Mac.

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

   # If you edit the CMakeLists.txt file you will need to delete the build directory contents (not the folder) and regenerate the makefiles
   cd cmake-build
   
   # Add -DDEBUG=ON to enable debug mode
   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
• Multiple Cores Support (SMP & Scheduler)
• Userland GUI
• CLI
• Porting & Dynamically Linking Libc
• Self-hosted os
• App Framework & System Apps
• DOOM Port
• UserSpace Drivers
• Userspace Networking
• Auto Updater & Image Builder
• Store
• User Switching
• Real Hardware Support
• Pretty GUI
• Port NeoVim, Wakatime & Some hot reloader
• Create port of my 2048
• Compatibility Layer(s)

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)