https://github.com/codeguardiansof/vortexos

VortexOS
https://github.com/codeguardiansof/vortexos

Last synced: about 2 months ago
JSON representation

VortexOS

• Host: GitHub
• URL: https://github.com/codeguardiansof/vortexos
• Owner: CodeGuardianSOF
• Created: 2024-10-11T13:03:05.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2024-10-19T18:45:16.000Z (3 months ago)
• Last Synced: 2024-10-20T07:32:26.302Z (3 months ago)
• Language: C
• Size: 88.9 KB
• Stars: 0
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Write Your Own 64-bit Operating System Kernel From Scratch

This respository holds all the source code for [this YouTube tutorial series](https://www.youtube.com/playlist?list=PLZQftyCk7_SeZRitx5MjBKzTtvk0pHMtp).

You can find the revision for a specific episode on [this page](https://github.com/davidcallanan/yt-os-series/tags).

You can find pre-built ISO files for this kernel at [this repository](https://github.com/davidcallanan/os-series-isos).

Considering supporting this work via [my Patreon page](http://patreon.com/codepulse).

## Prerequisites

 - A text editor such as [VS Code](https://code.visualstudio.com/).

 - [Docker](https://www.docker.com/) for creating our build-environment.

 - [Qemu](https://www.qemu.org/) for emulating our operating system.

   - Remember to add Qemu to the path so that you can access it from your command-line. ([Windows instructions here](https://dev.to/whaleshark271/using-qemu-on-windows-10-home-edition-4062))

## Setup

Build an image for our build-environment:

 - `docker build buildenv -t myos-buildenv`

## Build

Enter build environment:

 - Linux or MacOS: `docker run --rm -it -v "$(pwd)":/root/env myos-buildenv`

 - Windows (CMD): `docker run --rm -it -v "%cd%":/root/env myos-buildenv`

 - Windows (PowerShell): `docker run --rm -it -v "${pwd}:/root/env" myos-buildenv`

 - Please use the linux command if you are using `WSL`, `msys2` or `git bash`

 - NOTE: If you are having trouble with an unshared drive, ensure your docker daemon has access to the drive you're development environment is in. For Docker Desktop, this is in "Settings > Shared Drives" or "Settings > Resources > File Sharing".

Build for x86 (other architectures may come in the future):

 - `make build-x86_64`

 - If you are using Qemu, please close it before running this command to prevent errors.

To leave the build environment, enter `exit`.

## Emulate

You can emulate your operating system using [Qemu](https://www.qemu.org/): (Don't forget to [add qemu to your path](https://dev.to/whaleshark271/using-qemu-on-windows-10-home-edition-4062#:~:text=2.-,Add%20Qemu%20path%20to%20environment%20variables%20settings,-Copy%20the%20Qemu)!)

 - `qemu-system-x86_64 -cdrom dist/x86_64/kernel.iso`

 - Note: Close the emulator when finished, so as to not block writing to `kernel.iso` for future builds.

If the above command fails, try one of the following:

 - Windows: [`qemu-system-x86_64 -cdrom dist/x86_64/kernel.iso -L "C:\Program Files\qemu"`](https://stackoverflow.com/questions/66266448/qemu-could-not-load-pc-bios-bios-256k-bin)

 - Linux: [`qemu-system-x86_64 -cdrom dist/x86_64/kernel.iso -L /usr/share/qemu/`](https://unix.stackexchange.com/questions/134893/cannot-start-kvm-vm-because-missing-bios)

 - Alternatively, install a custom BIOS binary file and link it to Qemu using the `-L` option.

Alternatively, you should be able to load the operating system on a USB drive and boot into it when you turn on your computer. (I haven't actually tested this yet.)

## Cleanup

Remove the build-evironment image:

 - `docker rmi myos-buildenv -f`