Hobby kernel + userspace, built mostly from scratch. Composited GUI, dynamically linked ELF binaries, networking, Python applications, and more. https://toaruos.org/
|Kevin Lange 1c65d3d663 Include git short sha in version string instead of -dev||6 years ago|
|contrib||6 years ago|
|docs||6 years ago|
|hdd||6 years ago|
|kernel||6 years ago|
|modules||6 years ago|
|toolchain||6 years ago|
|userspace||6 years ago|
|util||6 years ago|
|.gitignore||6 years ago|
|LICENSE||6 years ago|
|Makefile||6 years ago|
|README.md||6 years ago|
とあるOS (ToAruOS) is a hobby kernel and supporting userspace, built mostly from scratch, in development since December of 2010.
It was originally developed at the University of Illinois at Urbana-Champaign. For a period of time, it was the development focus of the university's SIGOps chapter.
This repository contains the kernel, modules, and core userspace. Some third-party libraries and utilities are required to build a working system - these are automatically retrieved by the build process.
The kernel provides a number of features one would expect from a Unix-inspired project, including process and thread support, ELF binary support, runtime-loaded modules, pipes and TTYs, a virtual file system including virtual
/proc (inspired by Plan9 and Linux) and device files, EXT2 filesystem support, signals, and more.
The userspace provides a rich graphical environment with a composited window manager (built on Cairo), a terminal emulator (with support for xterm 256-color modes and Konsole 24-bit color modes, anti-aliased text using FreeType, and general support for some Unicode text), and other graphical demo applications.
The userspace depends on a number of third-party libraries which are outside of the development scope of the project, as well as the
newlib C library (though development of an in-house C library is planned).
Some third-party software is provided within this repository:
utf8decode.h, UTF8 decoding tools.
Licenses for these tools and libraries can be found here.
The following external libraries and tools are retrieved during the build process:
binutils- For both a cross-compiler and a native port.
newlib- C library (development of an in-house C library is planned, but has not yet commenced).
libpng- Used extensively by the native graphics library to provide wallpaper and icons.
zlib- Dependency of
libpng, but also generally useful.
freetype- For rendering text using TrueType fonts.
pixman- For CPU-accelerated graphics.
ncurses- Terminal control library, provides
In addition to the libraries included in the build process, others have been ported or successfully built for とある:
snes9x-sdl- See klange/snes9x-sdl
For a historical look at とあるOS, please see screenshots.md.
Please see testing.md.
For help building the kernel and userspace, join us in
#toaruos on Freenode (
This project is released under the terms of the University of Illinois / NCSA Open Source License, an OSI- and FSF-approved, GPL-compatible open source license. The NCSA License is a derivative of the MIT license and the BSD license; it is reproduced here for your convenience:
Copyright (c) 2011-2014 Kevin Lange. All rights reserved. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal with the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimers. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimers in the documentation and/or other materials provided with the distribution. 3. Neither the names of the ToAruOS Kernel Development Team, Kevin Lange, nor the names of its contributors may be used to endorse or promote products derived from this Software without specific prior written permission. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE CONTRIBUTORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS WITH THE SOFTWARE.