profanOS

This repo originally comes from part 23 of the excellent tutorial How to create an OS from scratch thanks!

You can find the list of things to do here

Setup

Note - compilation is guaranteed only on debian & co, but it is also possible in windows with virtualization solutions like wsl (on windows 11) or hyperV

Install dependencies

sudo apt-get update
sudo apt-get install -y gcc g++ nasm make qemu-system-i386 python3 grub-common xorriso grub-pc-bin mtools

Compile & Run

# Simple compilation
make

# Compile and run
make run

# Show all commands
make info

You can also download the build images from the repo profanOS-build or the latest release

OS documentation

shell.bin help

cat     - print file *              mem     - show MLIST with colors
cd      - change dir to *           mkdir   - create a new folder *
clear   - clear the screen          mkfile  - create a new file *
echo    - print the arguments       reboot  - reboot the system
exit    - exit of the shell app     sc      - show the scancodes
go      - start * file as binary    sleep   - sleep for a given time
help    - show this help            stop    - shutdown the system
info    - show time, task & page    udisk   - show used disk space
ls      - list the current dir

Known major bugs

bug name	exisiting since	description	fix idea
laged lag	?	parts of profanOS slow down at times on qemu	- memory address problem? - qemu problem?

Author & Contact

pf4 (@elydre)
Loris (@Lorisredstone)

Source & Acknowledgment

os tutorial for the original tutorial
fabian for the v86 online emulator and floppy build
framindmap for the mindmap of the todo list
yuukidesu9 for the iso creation
szhou42 for the ata driver
osdev for the multitasking

be careful with our friend 55

mazino3/profanOS