A comfy desktop environment for TempleOS
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.
Alec Murphy 31e8a5855b Merge pull request 'Core/Compositor: Added Compositor.SetWallpaper()' (#7) from GasInfinity/erythros:master into master 2 days ago
Boot Fix Indentation 2 days ago
System System: Add system log viewer for VirtualBox 3 months ago
.gitignore Add '.gitignore' 9 months ago
LICENSE Initial commit 9 months ago
README.md Update README.md 1 month ago
screenshot.png Update README.md 3 months ago



A comfy desktop environment for TempleOS



Erythros is a modern desktop environment which runs on top of stock, unmodified TempleOS Kernel.

It is a work in progress, and there is much more work to be done. If you would like to contribute, send an email to alec@checksum.fail and request access.


Matrix: Type /join !cqUdTDNXzGlqwfOuuS:envs.net


  • A supported hypervisor (QEMU recommended)

  • redseafs and Shrine Adam/Net (if using the included build-and-boot scripts)

  • A 9P server such as u9fs to provide a root filesystem (and socat if you use the sample config located in System)


It is recommended to use the build-and-boot scripts located in System if you intend to hack on the system with an IDE such as VSCode, CLion etc. that supports build tasks.

Alternatively, you can write the contents of Boot directory to an ISO.C file, using a tool such as RedSea Explorer for Windows or redseafs for Linux. You will need to manually add the files from Shrine in Adam/Net to 3rdParty/SnailNet in the ISO.C to provide networking support.

Mount the ISO.C file in the virtual CDROM drive.

Add the following to your Once.HC script:

blkdev.boot_drv_let = 'T';

By default, Erythros will attempt to mount a 9P root filesystem using the VM Network's gateway address, as it assumes a NAT configuration. You can modify Plan9FS.Init to set the values of Plan9FS.Host and Plan9FS.Port to match your setup if necessary.

Use the generate-root-paths.sh script located in System to create the required paths for the root filesystem.