🧠 A handcrafted 32-bit x86 Operating System
🕯️ Built in memory of Vio from SiegedSec
- In Memory of Vio
- About ViOS
- Features
- Project Structure
- Build Requirements
- Building ViOS
- Why ViOS?
- Contributing
- Contribution Guidelines
- Ideas to Get Involved
- Just Starting?
- License
- Author
Vio was a voice for transparency, a low-level coder, and a hacker who believed in teaching others how systems truly work. This OS is a tribute to that spirit. It is open, raw, and built to teach by showing—not just telling.
ViOS is a learning-focused multithreaded operating system for the x86 (32-bit) architecture. It features a full bootloader-to-kernel stack written in Assembly and C, and aims to be both an educational platform and a statement about digital autonomy.
-
🧬 Real Mode Bootloader (Assembly)
-
🧠 Protected Mode kernel (C)
-
🧷 Paging, heap, memory management
-
📁 FAT16 Filesystem parser
-
🧵 Process and task switching (multitasking support)
-
🧩 ELF executable loader
-
🔐 Virtual memory
-
📟 IO port & IRQ support
-
🌀 Disk reading/streamer layer
-
⌨️ Keyboard driver
-
💬 Minimal shell (WIP)
-
🛠️ Designed for use with GDB and QEMU
.
├── .env
├── .github
│ └── workflows
│ └── build.yml
├── .gitignore
├── assets
│ └── programs
│ ├── cpp_test
│ │ ├── Makefile
│ │ └── src
│ │ └── cpp_test.cpp
│ ├── shell
│ │ ├── linker.ld
│ │ ├── Makefile
│ │ └── src
│ │ ├── shell.c
│ │ └── shell.h
│ ├── stdlib
│ │ ├── linker.ld
│ │ ├── Makefile
│ │ └── src
│ │ ├── memory.c
│ │ ├── memory.h
│ │ ├── start.asm
│ │ ├── start.c
│ │ ├── stdio.c
│ │ ├── stdio.h
│ │ ├── stdlib.c
│ │ ├── stdlib.h
│ │ ├── string.c
│ │ ├── string.h
│ │ ├── vios.asm
│ │ ├── vios.c
│ │ └── vios.h
│ ├── stdlib++
│ │ ├── linker.ld
│ │ ├── Makefile
│ │ └── src
│ │ ├── audio.h
│ │ ├── memory.c
│ │ ├── memory.h
│ │ ├── start.asm
│ │ ├── start.cpp
│ │ ├── stdio.c
│ │ ├── stdio.h
│ │ ├── stdlib.c
│ │ ├── stdlib.h
│ │ ├── string.c
│ │ ├── string.h
│ │ ├── vios.asm
│ │ ├── vios.c
│ │ └── vios.h
│ └── vix_demo
│ ├── Makefile
│ └── src
│ └── vix_demo.c
├── build.sh
├── buildExternal.sh
├── docs
│ └── api
│ ├── copy_string_from_task.md
│ ├── disable_interrupts.md
│ ├── enable_interrupts.md
│ ├── heap_create.md
│ ├── heap_free.md
│ ├── heap_malloc.md
│ ├── idt_init.md
│ ├── isr80h_register_command.md
│ ├── kfree.md
│ ├── kheap_init.md
│ ├── kmalloc.md
│ ├── kzalloc.md
│ ├── paging_new_4gb.md
│ ├── paging_switch.md
│ ├── process_load.md
│ ├── process_switch.md
│ ├── README.md
│ ├── sys_exit.md
│ ├── sys_free.md
│ ├── sys_getkey.md
│ ├── sys_malloc.md
│ ├── sys_print.md
│ ├── sys_sleep.md
│ ├── task_current.md
│ ├── task_get_stack_item.md
│ ├── task_new.md
│ ├── task_switch.md
│ ├── vix_clear_screen.md
│ ├── vix_draw_pixel.md
│ └── vix_present_frame.md
├── generateFonts.sh
├── LICENSE
├── Makefile
├── README.md
├── run.sh
├── setupRemoteBuild.sh
├── src
│ ├── audio
│ │ ├── audio.c
│ │ ├── audio.h
│ │ ├── sb16.c
│ │ └── sb16.h
│ ├── boot
│ │ └── boot.asm
│ ├── config.h
│ ├── debug
│ │ ├── simple_serial.c
│ │ └── simple_serial.h
│ ├── disk
│ │ ├── disk.c
│ │ ├── disk.h
│ │ ├── streamer.c
│ │ └── streamer.h
│ ├── fs
│ │ ├── fat
│ │ │ ├── fat16.c
│ │ │ └── fat16.h
│ │ ├── file.c
│ │ ├── file.h
│ │ ├── pparser.c
│ │ └── pparser.h
│ ├── gdt
│ │ ├── gdt.asm
│ │ ├── gdt.c
│ │ └── gdt.h
│ ├── graphics
│ │ ├── graphics_arc.md
│ │ ├── graphics.c
│ │ ├── graphics.h
│ │ ├── renderer.c
│ │ └── renderer.h
│ ├── idt
│ │ ├── idt.asm
│ │ ├── idt.c
│ │ └── idt.h
│ ├── io
│ │ ├── io.asm
│ │ └── io.h
│ ├── isr80h
│ │ ├── file.c
│ │ ├── file.h
│ │ ├── heap.c
│ │ ├── heap.h
│ │ ├── io.c
│ │ ├── io.h
│ │ ├── isr80h.c
│ │ ├── isr80h.h
│ │ ├── process.c
│ │ ├── process.h
│ │ ├── vix_graphics.c
│ │ └── vix_graphics.h
│ ├── kernel
│ │ ├── init.c
│ │ ├── init.h
│ │ ├── mainloop.c
│ │ └── mainloop.h
│ ├── kernel.asm
│ ├── kernel.c
│ ├── kernel.h
│ ├── keyboard
│ │ ├── keyboard.c
│ │ ├── keyboard.h
│ │ ├── ps2_keyboard.c
│ │ └── ps2_keyboard.h
│ ├── linker.ld
│ ├── loader
│ │ └── formats
│ │ ├── elf.c
│ │ ├── elf.h
│ │ ├── elfloader.c
│ │ └── elfloader.h
│ ├── math
│ │ ├── fpu_math.c
│ │ └── fpu_math.h
│ ├── memory
│ │ ├── heap
│ │ │ ├── heap.c
│ │ │ ├── heap.h
│ │ │ ├── kheap.c
│ │ │ └── kheap.h
│ │ ├── memory.c
│ │ ├── memory.h
│ │ └── paging
│ │ ├── paging.asm
│ │ ├── paging.c
│ │ └── paging.h
│ ├── mouse
│ │ ├── mouse.c
│ │ ├── mouse.h
│ │ ├── ps2_mouse.c
│ │ └── ps2_mouse.h
│ ├── panic
│ │ ├── panic.c
│ │ └── panic.h
│ ├── rtc
│ │ ├── rtc.c
│ │ └── rtc.h
│ ├── status.h
│ ├── string
│ │ ├── string.c
│ │ └── string.h
│ ├── task
│ │ ├── process.c
│ │ ├── process.h
│ │ ├── task.asm
│ │ ├── task.c
│ │ ├── task.h
│ │ ├── tss.asm
│ │ └── tss.h
│ └── utils
│ ├── utils.c
│ └── utils.h
├── update_boot.sh
├── updateREADME.sh
├── utilities
│ ├── fonts
│ │ ├── Arial.ttf
│ │ ├── AtariST8x16SystemFont.ttf
│ │ ├── Brightly.otf
│ │ ├── Cheri.ttf
│ │ └── RobotoThin.ttf
│ └── generateFonts.py
└── ViOS_LOGO_PNG.png
45 directories, 180 files
Install the following:
-
nasm– Assembler -
i686-elf-gcc– Cross-compiler -
qemu– Emulator (optional) -
grub-mkrescue– ISO generation (optional)
brew install nasm qemu x86_64-elf-gccsudo apt install build-essential nasm qemu gcc-multilib grub-pc-bin xorrisoTo build the OS:
./build.shThis will:
- Assemble the bootloader and kernel
- Compile all components
- Link the final kernel binary to
./bin/os.bin - (If
grub-mkrescueis installed) Generate a bootable ISO image as./bin/os_disk.img
To emulate with QEMU:
qemu-system-i386 -kernel bin/os.binViOS is a platform for those who want to go deep into systems programming. It’s handcrafted, educational, and designed to be extended. Whether you’re learning how memory works or building custom features, ViOS is for you.
Contributions are highly encouraged and deeply appreciated. ViOS is more than an OS—it's a learning tool and a tribute to hacker culture. Whether you're fixing a bug, improving documentation, or building a whole new feature, your work helps keep the spirit of Vio and low-level computing alive.
-
Fork the Repo
Click the Fork button on GitHub to create your own copy of the project. -
Clone Your Fork
git clone https://github.com/YOUR_USERNAME/ViOS.git cd ViOS -
Create a New Branch
git checkout -b your-feature-name
-
Make Your Changes
Add your code, fix bugs, write docs, or improve the build system. -
Test Your Changes
Run./build.shand test the OS in QEMU:qemu-system-i386 -kernel bin/os.bin
-
Commit & Push
git add . git commit -m "Add: [short description of your change]" git push origin your-feature-name
-
Open a Pull Request
Go to your fork on GitHub and click New pull request.
-
Keep commits clean and descriptive.
-
If you’re adding new files, place them in a logical subdirectory.
-
Contributions can include:
-
🔧 Bug fixes
-
📄 Documentation
-
⚙️ Drivers or kernel features
-
💬 Shell improvements
-
📦 File system or memory improvements
-
-
🌐 Implement networking functionality (e.g. TCP/IP stack or USB Ethernet)
-
🌐 Implement networking functionality (e.g. TCP/IP stack or USB Ethernet)
-
📦 Add support for system updates or patching mechanism
-
🧠 Add new syscalls or user-mode execution support
-
🛠️ Expand the shell with built-in commands (like
ls,cat,cd) -
🧳 Build a lightweight
initsystem or process manager -
🧾 Add support for EXT4 or exFAT filesystems
-
🎮 Build demo applications or a TUI-based game on top of ViOS
-
🧬 Add long mode (x86_64) support
-
🧱 Add support for other architectures
No worries! Open an issue with a question, start a discussion, or contribute to the documentation to get your feet wet. Everyone starts somewhere—and every little bit helps.
"The OS belongs to everyone who dares to open the binary."
– You, after your first PR
MIT License — use it, fork it, build on it.
Just don’t forget where you came from.
Built and maintained by Hanna Skairipa
🔗 PinkQween on GitHub
"Not all hackers wear masks. Some wear purpose."
— Vio (SiegedSec)