Operating system for OpenComputers
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
XeonSquared c5f304380e one more try 2 months ago
cfg cleaner default source list 4 months ago
lib one more try 2 months ago
module added some more keyboard shortcuts to io.read linemode 2 months ago
service modify the two services people actually use to work with the new service semantics 4 months ago
.editorconfig clipboard: Make the clipboard service work under the new service sys 5 months ago
.gitignore clipboard: Make the clipboard service work under the new service sys 5 months ago
LICENSE Initial commit 2 years ago
README.md updated the README to represent the current state of the system 4 months ago
build.lua added the preproc library, meaning PsychOS is nominally self-hosting 5 months ago
build.sh bumped the version number because we selfhosting now 5 months ago
docs-metadata.yml added a title for PDF generation 5 months ago
finddesc.lua Fix document generation on Windows (using Git Bash) 5 months ago
gendoc.lua added doc() support for pre-compiled API documentation, wrote a generator for it, and included that in the build script 5 months ago
luapreproc.lua added type annotations and descriptions for functions where appropriate 5 months ago
package.sh added minitel to the default init, updated the package script 11 months ago
preproc.lua move actual preproc lib into folder rather than symlinking to the version in lib/, a better solution will be considered later 4 months ago
template.tex updated finddesc to use the new doc library, allowing type annotations and building a directory of documentation 5 months ago



A lightweight, multi-user operating system for OpenComputers


The kernel

The kernel is composed of a number of modules, found in the module/ directory. Which modules are included can be customised by changing the include statements in module/init.lua; copying it and customizing that is recommended, so you can git pull later without having to stash or reset your changes.

Unix-like systems

The kernel can be built using the preproc library and provided scripts:

lua build.lua module/init.lua kernel.lua


The kernel can be built from inside PsychOS using the preproc library, assuming you have the kernel source available:


The boot filesystem

A boot filesystem contains several things:

  • The kernel, as init.lua
  • The lib/ directory, containing libraries
  • The service/ directory, containing system services

This has been automated in the form of build.sh, pending a real makefile.


Documentation is generated as the system is built with build.sh; a set of markdown files will be placed into doc/, as well as an all-in-one apidoc.md. If pandoc is installed, an apidoc.pdf will also be generated.