FraniumOS

Quick Start

Option A — Windows (Fern launcher)

Fern is a one-click Windows GUI that builds and boots LitziumOS in QEMU — no terminal required.

Prerequisites

1. Install QEMU for Windows (default path C:\Program Files\qemu\ is auto-detected).
2. (Optional — UEFI boot) Place OVMF.fd next to fern.exe.

Build Fern (from WSL / Linux with MinGW-w64, or an MSYS2 mingw64 shell)

# WSL / Linux
sudo apt-get install mingw-w64
make -C fern            # → fern/fern.exe

# MSYS2 "MINGW64" shell
pacman -S mingw-w64-x86_64-gcc
make -C fern CROSS=     # → fern/fern.exe

Run

1. Open fern\fern.exe.
2. Click Browse → select your franium.iso.
3. Choose RAM, boot mode, display, and CPU count.
4. Click ▶ Launch — QEMU opens in a new window.

Tip: Use Dry Run to preview the assembled QEMU command, or Copy Command to paste it into a terminal or .bat file.

---

Option B — Terminal (Linux / WSL)

Prerequisites

sudo apt-get install build-essential nasm qemu-system-x86 \
     grub-pc-bin grub-common xorriso mtools

Build

make

Run in QEMU

make run

Debug with GDB

make run-gdb

# In another terminal:
gdb build/franium.elf -ex 'target remote :1234' -ex 'b kernel_main' -ex 'c'