2019-02-08 10:04:23 +00:00
# Serenity
2019-04-15 12:16:45 +00:00
Graphical Unix-like operating system for x86 computers.
2019-02-08 10:04:23 +00:00
2019-05-28 15:13:28 +00:00
2019-05-28 12:47:24 +00:00
2019-02-08 10:04:23 +00:00
## About
2019-04-30 13:27:35 +00:00
*I always wondered what it would be like to write my own operating system, but I never took it seriously. Until now.*
2019-03-08 00:10:33 +00:00
2019-04-30 13:27:35 +00:00
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.
2019-03-20 14:52:37 +00:00
2019-04-30 13:27:35 +00:00
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.
2019-02-08 10:04:23 +00:00
2019-04-30 13:27:35 +00:00
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 ](https://www.youtube.com/channel/UC3ts8coMP645hZw9JSD3pqQ ).
2019-04-15 12:16:45 +00:00
2019-04-15 12:17:44 +00:00
There's also a [Patreon ](https://www.patreon.com/serenityos ) if you would like to show some support that way.
2019-04-15 12:16:45 +00:00
2019-02-12 14:47:37 +00:00
## Screenshot
2019-04-30 13:27:35 +00:00
2019-02-12 14:47:37 +00:00
2019-02-08 10:04:23 +00:00
## Current features
* Pre-emptive multitasking
2019-04-05 23:31:12 +00:00
* Multithreading
2019-03-08 00:10:33 +00:00
* Compositing window server
2019-03-20 14:52:37 +00:00
* IPv4 networking with ARP, TCP, UDP and ICMP
2019-02-27 12:17:43 +00:00
* ext2 filesystem
2019-02-08 10:04:23 +00:00
* Unix-like libc and userland
2019-04-30 13:27:35 +00:00
* Shell with pipes and I/O redirection
2019-02-27 12:17:43 +00:00
* mmap()
* /proc filesystem
* Local sockets
2019-04-30 13:27:35 +00:00
* Pseudoterminals (with /dev/pts filesystem)
2019-04-15 12:16:45 +00:00
* Event loop library (LibCore)
* High-level GUI library (LibGUI)
2019-04-30 13:27:35 +00:00
* Visual GUI design tool
2019-04-05 23:31:12 +00:00
* PNG format support
2019-03-20 14:52:37 +00:00
* Text editor
* IRC client
* DNS lookup
2019-04-30 13:27:35 +00:00
* Desktop games: Minesweeper and Snake
2019-02-08 10:04:23 +00:00
* Other stuff I can't think of right now...
2019-03-20 14:52:37 +00:00
## How do I build and run this?
2019-02-17 08:45:39 +00:00
2019-04-30 13:27:35 +00:00
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.
2019-05-15 18:45:54 +00:00
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**.
2019-04-30 13:27:35 +00:00
Otherwise, see the older [step-by-step guide to building Serenity ](https://github.com/awesomekling/serenity/blob/master/Meta/BuildInstructions.md )
2019-02-17 08:45:39 +00:00
2019-05-03 14:25:15 +00:00
## IRC
Come chat in `#serenityos` on the Freenode IRC network.
2019-02-08 10:04:23 +00:00
## Author
* **Andreas Kling** - [awesomekling ](https://github.com/awesomekling )
2019-05-25 23:25:42 +00:00
* **Robin Burchell** - [rburchell ](https://github.com/rburchell )
2019-02-08 10:04:23 +00:00
## License
2019-04-15 12:16:45 +00:00
Serenity is licensed under a 2-clause BSD license.
