Truly independent web browser
Find a file
Andreas Kling 933a98f8fa Kernel: Make Lock::lock() assert early that we're not in the scheduler
The scheduler is not allowed to take locks, so if that's happening,
we want to make that clear instead of crashing with the more general
"Interrupts disabled while trying to take Lock" error.
2019-08-22 09:22:30 +02:00
AK NonnullPtrVector: Add ptr_at() getters for accessing the NonnullPtr 2019-08-19 19:04:52 +02:00
Applications TextEditor: Add a search bar that allows you to search for text 2019-08-21 21:30:20 +02:00
Base Inspector: Add a custom 16x16 icon to represent objects 2019-08-18 10:49:38 +02:00
Demos WindowServer+LibGUI: Pass window icons as shared buffers rather than paths. 2019-07-28 10:18:49 +02:00
DevTools Inspector: Show remote object properties in a table view 2019-08-19 20:29:52 +02:00
Documentation Documentation: Let's have a coding style document 2019-08-21 17:01:29 +02:00
Games Minesweeper: Make the SquareButtons non-checkable 2019-08-12 18:51:23 +02:00
Kernel Kernel: Make Lock::lock() assert early that we're not in the scheduler 2019-08-22 09:22:30 +02:00
Lagom Lagom: Disable building the IPC client/server apps for now 2019-08-05 14:03:15 +02:00
Libraries GTextEditor: Implement a simple text search API 2019-08-21 21:23:17 +02:00
Meta Meta: Add the script I use to refresh my Qt Creator project files 2019-08-16 16:39:56 +02:00
Ports Ports: mbedtls 2019-08-04 18:54:12 +02:00
Servers WindowServer: Oops, remove an assertion that won't fly with MBVGA 2019-08-19 13:50:09 +02:00
Shell Shell: Support forward delete 2019-08-18 07:36:23 +02:00
Toolchain Toolchain: Oops, we can't rely on "install.sh" to build LibC/LibM. 2019-07-22 08:48:08 +02:00
Userland Userland: Fix ifconfig use of /proc/net/adapters 2019-08-21 16:57:31 +02:00
.clang-format Meta: Tweak .clang-format to not wrap braces after enums. 2019-06-07 17:13:23 +02:00
.gitignore Meta: Fix .gitignore excluding files under Base/ 2019-08-17 12:07:55 +02:00
.travis.yml Travis: Try to install a modern C++ compiler for host compilations. 2019-07-10 22:03:46 +02:00
Contributing.md Meta: Add some more notes to the contribution guidelines 2019-08-17 21:45:06 +02:00
LICENSE Let's go with a 2-clause BSD license. 2019-04-15 14:04:23 +02:00
Makefile.common LibVT: Factor out terminal emulation from Terminal to make it reusable 2019-08-12 17:34:48 +02:00
ReadMe.md Meta: Update ReadMe with GCC 8 requirement 2019-08-21 11:50:40 +02: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 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 191112e

Current features

  • 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)
  • 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 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. Then source the UseIt.sh 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 ./makeall.sh, and if nothing breaks too much, take it for a spin by using ./run.

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.

Notes on WSL

SerenityOS can also be build and run under WSL Version 2. WSL Version 1 is not supported since Version 1 does not support ext2, which is needed for the setup.

WSL Version 2 is currently only available for Insider Builds of Windows which are more unstable and prone to crashes. Therefore, running SerenityOS on WSL Version 2 and running Insider Builds, in general, is not recommended on production systems.

Nevertheless, here is a guide on how to get an Insider Build and how to get WSL2. The installation then procedes as usual.

WSL2 does not natively support graphical applications. This means that to actually ./run SerenityOS, you need an X Server for windows. Vcxsrv is a good option. When you start up Vcxsrv, make sure to set the Display number to 0, and to Disable access control. Before actually doing ./run, you need to set the DISPLAY environmental variable as such:

export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0

This is due to a bug in WSL2. For more information, microsoft/WSL#4106.

Now you can finally, ./run.

IRC

Come chat in #serenityos on the Freenode IRC network.

Author

Contributors

Feel free to append yourself here if you've made some sweet contributions. :)

License

Serenity is licensed under a 2-clause BSD license.