Hobby kernel + userspace, built mostly from scratch. Composited GUI, dynamically linked ELF binaries, networking, Python applications, and more. https://toaruos.org/

Dale Weiler 01176e0f97 Use GAS instead of YASM. 8 years ago
hdd d8ac0fc902 Add a working (but read-only) volume knob to the panel. 8 years ago
kernel 01176e0f97 Use GAS instead of YASM. 8 years ago
modules 9d41b3fc25 Merge branch 'mixer-rebase' of https://github.com/gerow/toaruos into gerow-mixer-rebase 8 years ago
toolchain b0e14cad63 Export TOARU_SYSROOT for use in Makefiles 8 years ago
userspace 7f66c10230 Bind scroll to volume up/down on volume icon 8 years ago
util 01176e0f97 Use GAS instead of YASM. 8 years ago
.gitignore 01176e0f97 Use GAS instead of YASM. 8 years ago
.travis.yml a27444656c Disable notice for travis IRC notifications 8 years ago
LICENSE.md 91c51272bc Copyright years (hello 2015) 8 years ago
Makefile 01176e0f97 Use GAS instead of YASM. 8 years ago
README.md 9cf86430ee fix readme typo [ci skip] 8 years ago


Screenshot More Screenshots

ToaruOS (とあるOS)

とあるOS (ToaruOS) is a hobby kernel and supporting userspace, built mostly from scratch, in development since December of 2010.

This repository contains the kernel, modules, and core userspace. Some third-party libraries and utilities are required to build a working system.


ToaruOS started as a side project at the University of Illinois at Urbana-Champaign. For several months in late 2011 and early 2012, the University's SIGOps chapter managed development efforts focused on building the original compositing GUI. Since then, the project has mostly been a one-man effort with a handful of third party contributions.


The Toaru kernel provides a basic Unix-like environment. The kernel uses a hybrid modular architecture, with loadable modules providing most device driver support. The core kernel includes support for Unix pipes and TTYs, a virtual file system, multitasking, ELF binary support, and various core platform features on x86 systems.

Modules provide support for disk drives, ext2 filesystems, serial, keyboards and mice, a /proc filesystem similar to the one found in Linux, as well as an expanding collcetion of other device drivers.


ToaruOS's userspace is focused on a rich graphical environment, backed by an in-house compositing window manager. ToaruOS's terminal emulator supports xterm-compatible 256-color modes, as well as Konsole 24-bit color modes and anti-aliased text with basic Unicode support. Several graphical demos are provided, alongside a number of command-line applications. A port of SDL targetting the native graphical environment is also available.

Third-Party Software

The userspace depends on a number of third-party libraries which are outside of the development scope of the project. Additionally, several third-party applications and libraries have been integrated into ToaruOS's core userspace, or otherwise ported to ToaruOS.

Package Description
cpudet (included) cpuid parser
DejaVu Sans (included) Popular, free TrueType font series
VL Gothic (included) Free Japanese TrueType font
sha2.c (included) SHA512 hash library
utf8decode.h (included) UTF8 decoding tools
glxgears (included) Popular OpenGL demo
curses-hello (included) Curses demos
pci_list.h (included) PCI vendor and device names
2048 (included) Terminal implementation of a popular strategy game
gcc * Compiler suite.
newlib * C library
libpng * PNG graphics library
zlib * gzip compression library
FreeType` * TrueType font parser
Cairo * CPU-accelerated pixel-pushing and vector graphics
ncurses * Terminal UI library and terminfo provider
Mesa * Software OpenGL implementation
Vim * Popular text editor
Lua link Interpreted programming language
MuPDF link PDF viewer (requires complex library cross-compilation)
SDL link Cross-platform graphics library
Snes9X link SNES emulator
PrBoom` link DooM engine
Bochs link Software x86 PC emulator
Python (TBD) Interpreted programming language

* These tools and libraries are retrieved by the build process and included by default. Some of them are dependencies for the core userspace.

License for the included third-party tools and libraries can be found here.



For additional screenshots, see Screenshots.

For instructions on building, see Testing and Building.


For help building the kernel and userspace, join us in #toaruos on Freenode (irc.freenode.net).