system/serenity
system/serenity
1
0
Fork 0
mirror of https://github.com/SerenityOS/serenity synced 2024-07-22 18:46:18 +00:00
Code Issues Actions 5 Packages Projects Releases Wiki Activity
3458 commits 1 branch 0 tags 500 MiB
C++ 88%
JavaScript 4.8%
HTML 3.2%
C 1%
CMake 0.8%
Other 2.1%
Go to file
Andreas Kling 7cf4706a85 Meta: Advise people to wrap commit messages as 72 characters instead 
GitHub wraps shortlog messages at 72 characters, and this seems to be
the norm anyway, so let's just adapt.
2019-07-29 19:15:08 +02:00
AK Kernel+AK: Remove AK/StdLibExtras.cpp, moving kernel stuff to Kernel/. 2019-07-29 11:58:44 +02:00
Applications Kernel+ProcessManager: Let processes have an icon and show it in the table. 2019-07-29 07:26:01 +02:00
Base FileManager: Add a toolbar button for going to the home directory. 2019-07-21 09:19:09 +02:00
Demos WindowServer+LibGUI: Pass window icons as shared buffers rather than paths. 2019-07-28 10:18:49 +02:00
DevTools FormCompiler: Add some more LibCore object files to host build. 2019-07-26 22:42:10 +02:00
Documentation Documentation: Update SmartPointers.md with new pointer names. 2019-06-21 18:42:17 +02:00
Games WindowServer+LibGUI: Pass window icons as shared buffers rather than paths. 2019-07-28 10:18:49 +02:00
Kernel Kernel: Oops, forgot to add Lock.cpp. 2019-07-29 12:00:14 +02:00
Lagom Lagom: Let's not hard-code the compiler. Add compiler-relevant flags though. 2019-07-26 11:03:19 +02:00
Libraries AudioServer: Add a "main mix volume" and a simple program to get/set it 2019-07-29 19:06:58 +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 AudioServer: Add a "main mix volume" and a simple program to get/set it 2019-07-29 19:06:58 +02:00
Shell Shell: Put failed command exit statuses in the debug output instead. 2019-07-25 15:27:13 +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 AudioServer: Add a "main mix volume" and a simple program to get/set it 2019-07-29 19:06:58 +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
Contributing.md Meta: Advise people to wrap commit messages as 72 characters instead 2019-07-29 19:15:08 +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.