{"id":21941828,"url":"https://github.com/juls0730/cappuccinos","last_synced_at":"2025-07-05T21:40:27.002Z","repository":{"id":176813105,"uuid":"658486589","full_name":"juls0730/CappuccinOS","owner":"juls0730","description":"A small x86-64 rust os written from scratch","archived":false,"fork":false,"pushed_at":"2024-08-28T05:44:25.000Z","size":858,"stargazers_count":6,"open_issues_count":4,"forks_count":2,"subscribers_count":2,"default_branch":"trunk","last_synced_at":"2025-03-29T17:35:40.472Z","etag":null,"topics":["limine","limine-bootloader","operating-system","os","osdev","rust","rust-lang","x86-64"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/juls0730.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-25T22:07:27.000Z","updated_at":"2024-10-25T05:46:31.000Z","dependencies_parsed_at":"2023-10-02T05:46:52.208Z","dependency_job_id":"43e33321-4f66-4700-ad6b-2eb0bb769b64","html_url":"https://github.com/juls0730/CappuccinOS","commit_stats":null,"previous_names":["juls0730/toto-os"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juls0730%2FCappuccinOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juls0730%2FCappuccinOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juls0730%2FCappuccinOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juls0730%2FCappuccinOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/juls0730","download_url":"https://codeload.github.com/juls0730/CappuccinOS/tar.gz/refs/heads/trunk","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250296175,"owners_count":21407037,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["limine","limine-bootloader","operating-system","os","osdev","rust","rust-lang","x86-64"],"created_at":"2024-11-29T03:14:53.862Z","updated_at":"2025-04-22T18:11:09.458Z","avatar_url":"https://github.com/juls0730.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CappuccinOS\n\n\u003c!--\n    Use Tokei instead of a custom loc count, tokei and my custom loc count seem to disagree by 30-100 lines but I suspect tokei to be more accurate than cloc\n    ![LOC](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/juls0730/c16f26c4c5ab7f613fe758c913f9e71f/raw/cappuccinos-loc.json)\n--\u003e\n\n[![](https://tokei.rs/b1/github/juls0730/CappuccinOS?category=code\u0026type=Rust)](https://github.com/juls0730/CappuccinOS).\n\nCappuccinOS is a small _next generation_ x86-64 operating system written from scratch in Rust. This README will guide you through the process of building and running CappuccinOS.\n\n\u003e [!WARNING]\n\u003e This project is in early development. Things will change.\n\n## Features\n\n- [x] Serial output\n- [x] Hardware interrupts\n- [x] Heap allocation\n- [ ] Externalized kernel modules\n  - [x] Initramfs\n    - [x] Squashfs driver\n      - [x] Programmatic reads\n      - [x] Decompression\n- [ ] PS/2 Keyboard support\n- [ ] ANSI color codes in console\n- [ ] SMP\n  - [x] Use APIC instead of PIC\n- [ ] Pre-emptive multitasking\n  - [ ] Scheduling\n- [ ] File system\n  - [x] FAT file system (read-only rn)\n  - [ ] Ext2 file system\n- [ ] Block Device support\n  - [x] IDE device support\n  - [ ] SATA device support\n  - [ ] MMC/Nand device support\n  - [ ] M.2 NVME device support\n- [ ] Basic shell\n  - [ ] Basic I/O\n    - [ ] Executing Programs from disk\n- [ ] Lua interpreter\n- [x] Memory management\n- [ ] Network support\n- [ ] GUI\n- [ ] Device drivers\n  - [ ] Native intel graphics\n- [ ] User authentication\n- [ ] Power management\n- [ ] Paging\n- [ ] RTC Clock\n\n## Setup\n\nBefore building CappuccinOS, make sure you have the following installed on your machine:\n\n- rust\n- python\n- sgdisk\n- dosfstools\n- squashfs-tools\n- qemu (optional)\n\nClone the repo:\n\n```BASH\ngit clone https://github.com/juls0730/CappuccinOS.git\ncd CappuccinOS\n```\n\nInstall rust, if you haven't already:\n\n```BASH\ncurl https://sh.rustup.rs -sSf | sh -s -- -y --default-toolchain none\n```\n\nInstall the dependencies:\n\n\u003cdetails\u003e\n    \u003csummary\u003eArch\u003c/summary\u003e\n\n    sudo pacman -S gptfdisk dosfstools squashfs-tools python\n    # Optionally\n    sudo pacman -S qemu-system-x86\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n    \u003csummary\u003eUbuntu\u003c/summary\u003e\n    # Python should be installed by default, and if it's not, make an issue or a PR and I'll fix it\n\n    sudo apt install gdisk dosfstools squashfs-tools\n    # Optionally\n    sudo apt install qemu\n\n\u003c/details\u003e\n\n## Usage\n\nRun CappuccinOS with QEMU:\n\n```BASH\nmake run\n```\n\nIf you would like to just build CappuccinOS but not run it:\n\n```BASH\nmake build\n```\n\nIf you would like to target another architecture other than x86_64, set the `ARCH` variable to the a supported architecture. CappuccinOS is also built in release mode by default, if you would like to build CappuccinOS in debug mode, set the `MODE` variable to `debug`.\n\nRun on a bare metal machine by flashing to a USB stick or hard drive:\n\n```\nsudo dd if=bin/CappuccinOS.iso of=/dev/sdX bs=1M \u0026\u0026 sync\n```\n\n**Be careful not to overwrite your hard drive when using `dd`!**\n\n## Supported Architectures\n\n- x86_64\n- ~~aarch64~~ not in scope **might** not build\n- ~~RISC-V64~~ not in scope **might** not build\n\n## Credits an attributions\n\nInspiration was mainly from [JDH's Tetris OS](https://www.youtube.com/watch?v=FaILnmUYS_U), mixed with a growing interest in low level in general and an interest in learning rust (yeah, I started this project with not that much rust experience, maybe a CLI app or two, and trust me it shows).\n\nSome Resources I used over the creation of CappuccinOS:\n\n- [OSDev wiki](https://wiki.osdev.org)\n- Wikipedia on various random things\n- [Squashfs Binary Format](https://dr-emann.github.io/squashfs/squashfs.html)\n- [GRUB](https://www.gnu.org/software/grub/grub-download.html) Mainly for Squashfs things, even though I later learned it does things incorrectly\n\nAnd mostly for examples of how people did stuff I used these (projects made by people who might actually have a clue what they're doing):\n\n- This is missing some entries somehow\n- [MOROS](https://github.com/vinc/moros)\n- [Felix](https://github.com/mrgian/felix)\n- [mOS](https://github.com/Moldytzu/mOS)\n- [rust_os](https://github.com/thepowersgang/rust_os/tree/master)\n- [Lyre](https://github.com/Lyre-OS/klyre)\n- [Limine](https://github.com/limine-bootloader/limine) as my paging implementation is largely a rust translation of its\n\n```\nCopyright (C) 2019-2024 mintsuki and contributors.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are met:\n\n1. Redistributions of source code must retain the above copyright notice, this\n   list of conditions and the following disclaimer.\n\n2. Redistributions in binary form must reproduce the above copyright notice,\n   this list of conditions and the following disclaimer in the documentation\n   and/or other materials provided with the distribution.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\nWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\nDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\nSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER\nCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,\nOR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n```\n\n## License\n\nCappuccinOS is license under the MIT License. Feel free to modify and distribute in accordance with the license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuls0730%2Fcappuccinos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjuls0730%2Fcappuccinos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuls0730%2Fcappuccinos/lists"}