Skip to content
Serenity Operating System
C++ C Shell Makefile HTML Visual Basic Other
Branch: master
Clone or download
awesomekling Kernel: Move Thread::m_joinee_exit_value into the JoinBlocker
There's no need for this to be a permanent Thread member. Just use a
reference in the JoinBlocker instead.
Latest commit cb50214 Nov 14, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Meta: Add GitHub Sponsors to funding options Nov 2, 2019
AK HackStudio: Start fleshing out the GUI for a GUI designer :^) Nov 8, 2019
Applications LibPthread: Start working on a POSIX threading library Nov 13, 2019
Base Base: Add :^) Nov 12, 2019
Demos Demos: Remove useless PaintTest program Sep 29, 2019
DevTools HackStudio: Add a Stop action to kill the current process Nov 14, 2019
Documentation Meta: Move "Notes on WSL" to a separate file in Documentation/ Nov 6, 2019
Games LibCore: Remove ObjectPtr in favor of RefPtr Sep 21, 2019
Kernel Kernel: Move Thread::m_joinee_exit_value into the JoinBlocker Nov 14, 2019
Lagom Lagom: Fix TestApp to build after the CObject ref-counting changes Oct 7, 2019
Libraries Kernel+LibPthread: Implement pthread_join() Nov 14, 2019
Meta Toolchain: Add QEMU build script and improve documentation Nov 11, 2019
Ports Ports: Add support for zip files and ensure configure is executable (#… Nov 13, 2019
Servers LibPthread: Start working on a POSIX threading library Nov 13, 2019
Shell Shell: Exit the shell on (interactive) EOF with empty buffer Nov 1, 2019
Toolchain Toolchain: Add QEMU build script and improve documentation Nov 11, 2019
Userland Kernel+LibPthread: Implement pthread_join() Nov 14, 2019
.clang-format Meta: Tweak .clang-format to not wrap braces after enums. Jun 7, 2019
.gitignore Ports: Switch to new ports system (#594) Sep 24, 2019
.travis.yml Meta: Let's try giving Travis some valid YAML this time.. Sep 4, 2019 Meta: Move code of conduct (lol) to a separate file Oct 23, 2019 Meta: Remove CoC (lol) from since it has its own file Oct 23, 2019 Meta: Update install guide with instructions for booting into text mo… Nov 11, 2019
LICENSE Let's go with a 2-clause BSD license. Apr 15, 2019
Makefile.common LibPthread: Start working on a POSIX threading library Nov 13, 2019 Meta: Time for a new screenshot (Quake edition) :^) Nov 6, 2019


Graphical Unix-like operating system for x86 computers.

Travis CI status


I always wondered what it would be like to write my own operating system, but I never took it seriously. Until now.

Serenity is a love letter to '90s user interfaces with a custom Unix-like core. It flatters with sincerity by stealing beautiful ideas from various other systems.

Roughly speaking, the goal is a marriage between the aesthetic of late-1990s productivity software and the power-user accessibility of late-2000s *nix. This is a system by me, for me, based on the things I like.

If you like some of the same things, you are welcome to join the project. It would be great to one day change the above to say "this is a system by us, for us, based on the things we like." :^)

I regularly post raw hacking sessions and demos on my YouTube channel.

Sometimes I write about the system on my blog.

There's also a Patreon if you would like to show some support that way.


Screenshot as of 1133aca

Current features (all under development)

  • Pre-emptive multitasking
  • Multithreading
  • Compositing window server
  • IPv4 networking with ARP, TCP, UDP and ICMP
  • ext2 filesystem
  • Unix-like libc and userland
  • POSIX signals
  • Shell with pipes and I/O redirection
  • mmap()
  • /proc filesystem
  • Local sockets
  • Pseudoterminals (with /dev/pts filesystem)
  • Filesystem notifications
  • JSON framework
  • Low-level utility library (LibCore)
  • Mid-level 2D graphics library (LibDraw)
  • High-level GUI library (LibGUI)
  • HTML/CSS engine
  • Web browser
  • C++ IDE
  • Emojis (UTF-8)
  • HTTP downloads
  • SoundBlaster 16 driver
  • Software-mixing sound daemon
  • WAV playback
  • Simple desktop piano/synthesizer
  • Visual GUI design tool
  • PNG format support
  • Text editor
  • IRC client
  • Simple painting application
  • DNS lookup
  • Desktop games: Minesweeper and Snake
  • Ports system (needs more packages!)
  • Other stuff I can't think of right now...

How do I build and run this?

Make sure you have all the dependencies installed:

sudo apt install build-essential curl libmpfr-dev libmpc-dev libgmp-dev e2fsprogs qemu-system-i386 qemu-utils

Ensure your gcc version is >= 8 with gcc --version. Otherwise, install it (on Ubuntu) with:

sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt-get install gcc-8 g++-8
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-8 800 --slave /usr/bin/g++ g++ /usr/bin/g++-8

Go into the Toolchain/ directory and run the script. Then source the script to put the i686-pc-serenity toolchain in your $PATH.

Once you've done both of those, go into the Kernel/ directory, then run ./, and if nothing breaks too much, take it for a spin by using ./run.

You can vastly reduce the build time of successive rebuilds of Serenity by installing ccache and exporting PRE_CXX=ccache

Bare curious users may even consider sourcing suitable hardware to install Serenity on a physical PC.

Later on, when you git pull to get the latest changes, there's no need to rebuild the toolchain. You can simply rerun ./ in the Kernel/ directory and you'll be good to ./run again.


Come chat in #serenityos on the Freenode IRC network.



(And many more!) Feel free to append yourself here if you've made some sweet contributions. :)


Serenity is licensed under a 2-clause BSD license.

You can’t perform that action at this time.