berkus
/
essence-os
mirror of https://gitlab.com/nakst/essence
1
0
Fork 0
Code Releases Activity
210 Commits 1 Branch 0 Tags 45 MiB
C 52.6%
C++ 44%
Shell 1.2%
Assembly 0.9%
Meson 0.8%
Other 0.5%
Go to file
nakst 3ad305c4fd designer2 add switcher 2021-10-11 14:46:04 +01:00
apps mark _EsSyscall private 2021-10-09 22:05:09 +01:00
boot/x86 better support for running on real hardware 2021-09-22 19:01:29 +01:00
desktop theme file cleanup 2021-10-10 18:57:02 +01:00
drivers use PIT for scheduler time; RTC driver; date conversion functions; add EsDateNowUTC 2021-10-10 16:11:13 +01:00
kernel use PIT for scheduler time; RTC driver; date conversion functions; add EsDateNowUTC 2021-10-10 16:11:13 +01:00
ports bugfixes 2021-10-08 21:57:58 +01:00
res designer2 add switcher 2021-10-11 14:46:04 +01:00
shared use PIT for scheduler time; RTC driver; date conversion functions; add EsDateNowUTC 2021-10-10 16:11:13 +01:00
util designer2 add switcher 2021-10-11 14:46:04 +01:00
.gitignore hide email 2021-08-13 21:22:26 +01:00
CONTRIBUTING.md hide email 2021-08-13 21:22:26 +01:00
LICENSE.md add hsluv.h 2021-09-29 09:17:47 +01:00
README.md converter sample application 2021-09-24 09:39:49 +01:00
start.sh merge patch for building on macOS 2021-09-24 13:54:10 +01:00

README.md

Essence — An Operating System

Screenshot of the operating system running in an emulator, showing File Manager, and the new tab screen. Screenshot of the operating system running in an emulator, showing GCC running under the POSIX subsystem. Screenshot of the operating system running in an emulator, showing the shutdown dialog.

Support

To support development, you can donate to my Patreon: https://www.patreon.com/nakst.

Features

Kernel

  • Filesystem independent cache manager.
  • Memory manager with shared memory, memory-mapped files and multithreaded paging zeroing and working set balancing.
  • Networking stack for TCP/IP.
  • Scheduler with multiple priority levels and priority inversion.
  • On-demand module loading.
  • Virtual filesystem.
  • Window manager.
  • Audio mixer. (being rewritten)
  • Optional POSIX subsystem, capable of running GCC and some Busybox tools.

Applications

  • File Manager
  • Text Editor
  • IRC Client
  • System Monitor

Ports

  • Bochs
  • GCC and Binutils
  • FFmpeg
  • Mesa (for software-rendered OpenGL)
  • Musl

Drivers

  • Power management: ACPI with ACPICA.
  • Secondary storage: IDE, AHCI and NVMe.
  • Graphics: BGA and SVGA.
  • Read-write filesystems: EssenceFS.
  • Read-only filesystems: Ext2, FAT, NTFS, ISO9660.
  • Audio: HD Audio.
  • NICs: 8254x.
  • USB: XHCI, bulk storage devices, human interface devices.

Desktop

  • Custom user interface library.
  • Software vector renderer with complex animation support.
  • Tabbed windows.
  • Multi-lingual text rendering and layout with FreeType and Harfbuzz.

Discussion

Join our Discord server: https://discord.gg/skeP9ZGDK8

Alternatively, visit the forums (not very active): https://essence.handmade.network/forums.

Building

Warning: This software is still in development. Expect bugs.

Linux

Download this project's source.

git clone --depth=1 https://gitlab.com/nakst/essence.git/

Start the build system.

./start.sh

Follow the on-screen instructions to build a cross compiler.

Once complete, you can test the operating system in an emulator.

  • If you have Qemu and KVM installed, run k in the build system. Recommended!
  • If you have Qemu installed, run t2 in the build system.
  • If you have VirtualBox installed, make a 128MB drive called vbox.vdi in the bin folder, attach it to a virtual machine called "Essence" (choose "Windows 7 64-bit" as the OS), and run v in the build system.

Configuration

From within the build system, run the command config to open the configuration editor. Click an option to change its value, and then click the Save button. You changes are saved locally, and will not be uploaded by Git. Not all configurations are likely to work; if you don't know what you're doing, it's probably best to stick with the defaults.

Generating the API header

If you want your project to target Essence, you need to generate the API header for your programming language of choice.

g++ -o bin/build_core util/build_core.c
bin/build_core headers <language> <path-to-output-file>

Currently supported languages are 'c' (also works for C++), 'zig' and 'odin'.

There is currently no documentation for the API; for examples of how to use the API, consult the standard applications in the apps/ folder of the source tree. Minimal sample applications are placed in the apps/samples folder. By placing your application's .ini file in the apps/ folder, it will be automatically built by the build system.