# WingOS

**Repository Path**: pwn2security/WingOS

## Basic Information

- **Project Name**: WingOS
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: BSD-2-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2021-10-22
- **Last Updated**: 2022-08-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

![Banner](screen_shot/wingOS.png)

----

# Wingos
![GitHub commit activity](https://img.shields.io/github/commit-activity/w/Supercip971/Wingos)
 [![License](https://img.shields.io/github/license/cute-engineewing/mulib?style=flat-square)](./LICENSE)
 [![Codacy Badge](https://app.codacy.com/project/badge/Grade/a93122f607b943fd960639747f19f29c)](https://www.codacy.com/gh/Supercip971/WingOS/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=Supercip971/WingOS&amp;utm_campaign=Badge_Grade)

WingOS is a small hobbyist 64 bit kernel made with <3 in C++ 

Note: the userspace is not really developed right now, there are not really functional binutils nor useful applications, for the moment I prefer developing the kernel than the userspace.

Note2: for the moment I am working on [Brutal](https://github.com/brutal-org/brutal) a super cool microkernel written in C.

</div>

## Contact 

- Email: supercyp@protonmail.com

- Discord server: [xK8jEswcyx](https://discord.gg/xK8jEswcyx)
## Try it

If you just want to try the os **without building** it, you can just install Qemu, and grab the latest Artifacts in the github action.

Configuration for running qemu: 

[MEMORY] : recommended memory: 4G | minimum: 2G

[CPU_CORES] : recommended : 6 | minimum : 1 (warning: 1 cpu core is really slow)
```sh
qemu-system-x86_64 -m [MEMORY] -s -device pvpanic -smp [CPU_CORES] -serial stdio -enable-kvm -d cpu_reset -d guest_errors -hda [DISK_PATH] -nic user,model=e1000 -M q35 -cpu host 
```
## Building
for building you can take a look at the [Build guide](./Build_guide.md)

## Contributing to the libutils or libc without building the kernel
if you want to contribute to the libc/libutils without having to build the kernel you can just edit the library and test it in the unit-test directory 
this is for testing the library in a linux environment 

## Supported features 

- pci
- ahci
- sata
- ata
- e1000
- syscall/sysret
- ext2fs
- smp (multi cpu)
- little gui
- basic module (for the moment we have the mouse and keyboard module in the userspace)
- basic ipc
- basic terminal
- ...

## License: 
This project use the BSD 2-Clause License  
## Screenshots:

![sample](screen_shot/sample6_11_05_2021png.png)