A simple, modern, 64 bit operating system.

• Derecho
  • About this project
  • Running Derecho
  • Contributing to Derecho

I've been interested in OS Dev for ages, but the past few projects I've tried never really got off the ground. This one's gonna work.

The objective is to provide a TUI workstation - no graphics libraries are planned to be developed (but feel free to fork and make your own!). Modern standards are to be used, so this project is 64 bit UEFI compliant.

Disclaimer: Derecho is a very basic Operating System. There's no hand-holding and it's still very much in alpha, so run at your own risk.

Firstly, run setup/setup-(os).sh to install all the necessary build packages for your operating system. These scripts will require root access in order to work, but they'll prompt you for sudo. Once the install is complete, run make in the project root. A file called Derecho.img will be created - this is a disk image of the OS. From here, write this to a USB stick with your favourite tool (popsicle is known to work, make sure you also install udisks2 as a patch). Then plug it into a device of your choice (make sure it's booting with UEFI) and boot from the USB. Alternatively, you can run make run in the terminal to boot Derecho using QEMU.

Contributions are very welcome! I'm just a man, and my time isn't plentiful in nature, but I promise I'll process any pull requests as soon as I can.

• A value isn't necessarily guaranteed to be a given value when declared - sometimes this means ignoring a guard statement, other times it means getting creative about how you set variables.

To start contributing, run setup/setup-(os).sh as described in Running Derecho. From there, write your changes and run make to compile the source code, or make run to run the compiled OS in QEMU.

Development is pretty open-ended so do whatever you want, but there's a few things to adhere to:

• The development language is British English. If you don't know what that looks like, it's the code I write.
• Indent using tabs (equivalent to four spaces).
• No languages other than C and Assembly (using Intel syntax).
• C header files use #pragma once as guard statements.
• Use LF, not CRLF (Windows users beware!).

Want some ideas of what to implement? Here's some to get you started:

• Setup scripts for other operating systems and linux distros (read setup/setups.md).
• Support for other languages (French, German, Spanish, Italian, Russian, Te Reo Māori).
• Better font management, maybe try get extended UTF-8?