https://github.com/sniverdabest/lemoncake

An OS made in Rust.
https://github.com/sniverdabest/lemoncake

operating-system os rust

Last synced: 6 months ago
JSON representation

An OS made in Rust.

• Host: GitHub
• URL: https://github.com/sniverdabest/lemoncake
• Owner: SniverDaBest
• License: bsd-2-clause
• Created: 2025-03-01T02:51:59.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-10-04T03:54:41.000Z (6 months ago)
• Last Synced: 2025-10-04T05:45:36.469Z (6 months ago)
• Topics: operating-system, os, rust
• Language: Rust
• Homepage: https://sniverdabest.github.io/lemoncake
• Size: 1.61 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![](https://tokei.rs/b1/github/SniverDaBest/lemoncake)](https://github.com/SniverDaBest/lemoncake)

[![](https://img.shields.io/github/actions/workflow/status/SniverDaBest/lemoncake/rust.yml?style=plastic&color=fish)](https://github.com/SniverDaBest/lemoncake/actions/)

[![](https://img.shields.io/github/languages/top/SniverDaBest/lemoncake?style=plastic&color=%23ef5124)](https://github.com/SniverDaBest/lemoncake)

[![](https://img.shields.io/github/license/SniverDaBest/lemoncake?style=plastic&color=%23b60110)](https://github.com/SniverDaBest/lemoncake/blob/main/LICENSE)

# Info

Lemoncake is a small OS, that was originally called `lemonade`. However, I have come to dislike that name, and dislike the rest of the codebase. So, it's been scrapped, and it's renamed.\

\

It's written in Rust, with a chance some code in other languages may be written eventually..\

\

Here's a picture of it running:

![](https://github.com/user-attachments/assets/931f4e19-421a-4f88-b083-c0b8c6cb7fd6)

>[!TIP]

> If you're having issues, try running the utility script.\

> You can do so with the following command: `python utils.py`\

> The script creates the hard disk image, and uses `rustup` to install some components and target info.

# Dependencies

To build, you can run `cargo build` in the root project directory.\

\

The only dependencies you'll need are:

- Cargo

- Qemu

- Python

- mkfs.fat (dosfstools, i think?)

# Running it yourself

>[!CAUTION]

> It isn't recommended to run this on your host PC, as it could possibly break something that you need, wipe a drive, etc.

You can check it out in Qemu, by just running `cargo run` in the root project directory.\

If you want, you could also use VirtualBox, VMWare, or maybe something else to emulate it, but it won't happen with `cargo run`, you'd need to manually do that yourself.

>[!TIP]

> If you're having issues with running QEMU, try removing the `--enable-kvm` flag from the command in the build script.

# Contributions

Contributions would by highly appreciated!

# License

Lemoncake uses the BSD 2-clause (simplified) license. Check `LICENSE` for the full license.