Truly independent web browser
Find a file
Jesse Buhagiar bd33c66273 Kernel: Move Kernel mapping to 0xc0000000
The kernel is now no longer identity mapped to the bottom 8MiB of
memory, and is now mapped at the higher address of `0xc0000000`.

The lower ~1MiB of memory (from GRUB's mmap), however is still
identity mapped to provide an easy way for the kernel to get
physical pages for things such as DMA etc. These could later be
mapped to the higher address too, as I'm not too sure how to
go about doing this elegantly without a lot of address subtractions.
2019-11-22 16:23:23 +01:00
.github Meta: Add GitHub Sponsors to funding options 2019-11-02 23:32:34 +01:00
AK LibHTML+AK: Move URL completion from Document to AK::URL 2019-11-19 17:46:36 +01:00
Applications Browser: Add a debug menu action to dump the current style sheets 2019-11-21 19:52:09 +01:00
Base LibHTML: Handle stand-alone attribute selectors 2019-11-21 20:19:00 +01:00
Demos Demos: Remove useless PaintTest program 2019-09-29 19:54:30 +02:00
DevTools HackStudio: Always re-match curlies/parens after a re-highlight 2019-11-18 19:21:18 +01:00
Documentation Meta: Move "Notes on WSL" to a separate file in Documentation/ 2019-11-06 21:03:18 +01:00
Games LibCore: Remove ObjectPtr in favor of RefPtr 2019-09-22 00:31:54 +02:00
Kernel Kernel: Move Kernel mapping to 0xc0000000 2019-11-22 16:23:23 +01:00
Libraries LibHTML: Handle stand-alone attribute selectors 2019-11-21 20:19:00 +01:00
Meta Lagom: Fix build 2019-11-19 11:14:26 +01:00
Ports Ports: Make sure Bash loads its built-in commands statically 2019-11-19 16:03:25 +01:00
Servers AudioServer: Make all source files depend on generated sources 2019-11-19 20:10:38 +01:00
Shell Shell: Exit the shell on (interactive) EOF with empty buffer 2019-11-01 21:44:25 +01:00
Toolchain Toolchain: Add QEMU build script and improve documentation 2019-11-11 21:29:56 +01:00
Userland Kernel+LibPthread: pthread_create handles pthread_attr_t 2019-11-18 09:04:32 +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 .DS_Store to .gitignore (#786) 2019-11-15 22:19:47 +01:00
.travis.yml Meta: Let's try giving Travis some valid YAML this time.. 2019-09-04 11:45:43 +02: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.common Build: Make sure we look in Libraries/LibPthread for libraries :^) 2019-11-16 12:23:40 +01:00
ReadMe.md Meta: Time for a new screenshot (Quake edition) :^) 2019-11-06 21:51:33 +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. 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.

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.