STEP 01 — BUILD
Compile the image.
Run the project’s Make target to create `build/velocityos.img`.
make02 / BUILD GUIDE
Build it.
Boot it.
Look closer.
Make a disk image, run it in an emulator, and trace the path from bootloader to desktop.
VELOOS / QUICK START01 / GET READYTOOLS ON THE HOST
A few tools.
One image.
VeloOS builds into a 1.44 MB floppy image. The README lists NASM, Clang, and Python 3 as requirements.
Read the project README01NASMAssembler
02ClangLLVM compiler
03Python 3Build tooling
04QEMUFor the emulator run
02 / MAKE A DISKFROM THE REPOSITORY ROOT
Build, then run.
STEP 02 — EMULATE
Boot in QEMU.
Start the image as a floppy drive with 512 MB of memory.
qemu-system-i386 \
-drive file=build/velocityos.img,format=raw,if=floppy \
-boot order=a -m 512By default, VeloOS boots straight to the graphical desktop. Hold Shift during early boot to open the boot menu.
03 / BOOT OPTIONSHOLD SHIFT DURING EARLY BOOT
Choose your
starting point.
1NormalText shell
2Safe modeMinimal startup
3Graphical desktopVESA environment
04 / WHAT'S NEXTWORK IN PROGRESS
The machine
is still opening up.
Protected-mode kernel, interrupts, and memory manager
VESA desktop, window manager, and compositor
ATA / IDE disk driver
FAT32 filesystem and USB support
EVERY STEP IS IN THE REPO