Truly independent web browser
Go to file
Stefano Cristiano b62dbcbf59 Build: Disable compiling tests on macOS host
Tests fail to compile for a mix of reasons, some due to macOS file systems
being by default case-insensitive and some specific to clang.
Both issues are better left to a dedicated set of PR that addressed them.
2019-12-27 02:19:55 +01:00
.github Meta: Add GitHub Sponsors to funding options 2019-11-02 23:32:34 +01:00
AK AK: Simplify const T& versions of append/insert in SinglyLinkedList 2019-12-27 02:15:45 +01:00
Applications PaintBrush: Add an "ellipse tool" 2019-12-27 00:52:17 +01:00
Base PaintBrush: Add an "ellipse tool" 2019-12-27 00:52:17 +01:00
Demos Build: support library and generator dependencies 2019-12-25 10:11:09 +01:00
DevTools HackStudio: Fix failure to open files 2019-12-26 10:19:44 +01:00
Documentation Meta: Move "Notes on WSL" to a separate file in Documentation/ 2019-11-06 21:03:18 +01:00
Games Build: support library and generator dependencies 2019-12-25 10:11:09 +01:00
Kernel Kernel: Add kernel-level timer queue (heavily based on @juliusf's work) 2019-12-27 02:15:45 +01:00
Libraries LibCore: Allow LibCore to be compiled on macOS host 2019-12-27 02:19:55 +01:00
MenuApplets Build: support library and generator dependencies 2019-12-25 10:11:09 +01:00
Meta Meta: refresh-serenity-qtcreator.sh now checks if SERENITY_ROOT is set 2019-12-24 11:12:00 +01:00
Ports Ports: Build nesalizer in release mode 2019-12-25 23:57:25 +01:00
Servers LibGUI+WindowServer: Mark minimized window backing stores as volatile 2019-12-26 12:06:07 +01:00
Shell Build: support library and generator dependencies 2019-12-25 10:11:09 +01:00
Toolchain Toolchain: Statically link serenity cross-compiler on macOS to keep the cross-toolchain self contained 2019-12-27 02:19:55 +01:00
Userland munch: Add a simple userland program for chewing up lots of memory 2019-12-26 11:48:34 +01:00
.clang-format Meta: Tweak .clang-format to not wrap braces after enums. 2019-06-07 17:13:23 +02:00
.gitignore Meta: Add ccls-cache to gitignore 2019-12-24 02:19:59 +01:00
.travis.yml Travis: We don't have UseIt.sh anymore :^) 2019-12-21 00:19:49 +01:00
CODE_OF_CONDUCT.md Meta: Move code of conduct (lol) to a separate file 2019-10-23 10:05:06 +02:00
CONTRIBUTING.md Meta: Remove CoC (lol) from CONTRIBUTING.md since it has its own file 2019-10-23 12:19:41 +02:00
INSTALL.md Meta: Update install guide with instructions for booting into text mode (#758) 2019-11-11 13:11:00 +01:00
LICENSE Let's go with a 2-clause BSD license. 2019-04-15 14:04:23 +02:00
Makefile Build: Disable compiling tests on macOS host 2019-12-27 02:19:55 +01:00
Makefile.common Build: Disable unknown GCC specific warnings when compiling host tools using clang 2019-12-27 02:19:55 +01:00
Makefile.subdir Build: clean up build system, use one shared Makefile 2019-12-20 20:20:54 +01:00
ReadMe.md Build: get rid of UseIt.sh 2019-12-20 23:55:08 +01:00

Serenity

Graphical Unix-like operating system for x86 computers.

Travis CI status

About

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 github.io blog.

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

Screenshot

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 BuildIt.sh script.

Once you've built the toolchain, go into the Kernel/ directory, then run ./makeall.sh, 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 ./makeall.sh in the Kernel/ directory and you'll be good to ./run again.

IRC

Come chat in #serenityos on the Freenode IRC network.

Author

Contributors

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

License

Serenity is licensed under a 2-clause BSD license.