system/serenity
system/serenity
1
0
Fork 0
mirror of https://github.com/SerenityOS/serenity synced 2024-07-21 01:55:07 +00:00
Code Issues Actions 5 Packages Projects Releases Wiki Activity
3375 commits 1 branch 0 tags 497 MiB
C++ 88%
JavaScript 4.8%
HTML 3.2%
C 1%
CMake 0.8%
Other 2.1%
Go to file
Andreas Kling afc638c3ab AK: Allow NonnullRefPtr::ptr() when in "unknown" typestate. 
Clang loses the typestate when passing NonnullRefPtr's via lambda captures.
This is unfortunate, but not much we can do about it. Allowing ptr() makes
it possible to use captured NonnullRefPtrs as you'd expect.
2019-07-25 11:51:24 +02:00
AK AK: Allow NonnullRefPtr::ptr() when in "unknown" typestate. 2019-07-25 11:51:24 +02:00
Applications AK: Make HashMap::get(Key) return an Optional<Value>. 2019-07-24 10:25:43 +02:00
Base FileManager: Add a toolbar button for going to the home directory. 2019-07-21 09:19:09 +02:00
Demos LibGUI: Get rid of GWindow::should_exit_event_loop_on_close(). 2019-07-23 18:20:00 +02:00
DevTools AK: Make HashMap::get(Key) return an Optional<Value>. 2019-07-24 10:25:43 +02:00
Documentation Documentation: Update SmartPointers.md with new pointer names. 2019-06-21 18:42:17 +02:00
Games LibGUI: Get rid of GWindow::should_exit_event_loop_on_close(). 2019-07-23 18:20:00 +02:00
Kernel AK: Make HashMap::get(Key) return an Optional<Value>. 2019-07-24 10:25:43 +02:00
Libraries CSocket: Add missing <sys/un.h> include to fix host build. 2019-07-25 11:49:08 +02:00
Meta Meta: Removed all gitignore in the source tree only keeping the root one 2019-06-30 10:41:26 +02:00
Ports Ports: Add GNU make 4.2! :^) 2019-07-21 19:26:02 +02:00
Servers AK: Make HashMap::get(Key) return an Optional<Value>. 2019-07-24 10:25:43 +02:00
Shell Shell: Simply print "cmd: Command not found." for ENOENT on execution. 2019-07-25 07:05:38 +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 Kernel: Add a mechanism for listening for changes to an inode. 2019-07-22 20:01:11 +02:00
.clang-format Meta: Tweak .clang-format to not wrap braces after enums. 2019-06-07 17:13:23 +02:00
.gitignore Meta: Removed all gitignore in the source tree only keeping the root one 2019-06-30 10:41:26 +02:00
.travis.yml Travis: Try to install a modern C++ compiler for host compilations. 2019-07-10 22:03:46 +02:00
LICENSE Let's go with a 2-clause BSD license. 2019-04-15 14:04:23 +02:00
Makefile.common LibDraw: Introduce (formerly known as SharedGraphics.) 2019-07-18 10:18:16 +02:00
ReadMe.md Meta: Add note about rebuilding after pulling new changes. 2019-07-01 14:33:31 +02:00

ReadMe.md

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)
  • JSON framework
  • Low-level utility library (LibCore)
  • High-level GUI library (LibGUI)
  • 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

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.

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.