{"id":13692293,"url":"https://github.com/29jm/SnowflakeOS","last_synced_at":"2025-05-02T19:31:51.728Z","repository":{"id":34507990,"uuid":"38449214","full_name":"29jm/SnowflakeOS","owner":"29jm","description":"\"It is very special\"","archived":false,"fork":false,"pushed_at":"2024-12-17T21:01:30.000Z","size":5880,"stargazers_count":316,"open_issues_count":5,"forks_count":18,"subscribers_count":12,"default_branch":"master","last_synced_at":"2024-12-17T22:18:12.848Z","etag":null,"topics":["hobby-os","kernel","os","osdev"],"latest_commit_sha":null,"homepage":"https://jmnl.xyz","language":"C","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/29jm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2015-07-02T18:18:01.000Z","updated_at":"2024-12-17T21:01:37.000Z","dependencies_parsed_at":"2024-11-12T18:34:53.843Z","dependency_job_id":"c41d7c44-0b70-488d-aafe-e6496f704ba8","html_url":"https://github.com/29jm/SnowflakeOS","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/29jm%2FSnowflakeOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/29jm%2FSnowflakeOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/29jm%2FSnowflakeOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/29jm%2FSnowflakeOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/29jm","download_url":"https://codeload.github.com/29jm/SnowflakeOS/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252095284,"owners_count":21693895,"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":["hobby-os","kernel","os","osdev"],"created_at":"2024-08-02T17:00:55.954Z","updated_at":"2025-05-02T19:31:49.908Z","avatar_url":"https://github.com/29jm.png","language":"C","funding_links":[],"categories":["Projects"],"sub_categories":["Operating Systems"],"readme":"# SnowflakeOS\n\n![A picture is worth, like, a few words](https://29jm.github.io/assets/sos-paint.jpg)\n\nA hobby OS to help me learn about kernel stuff, to eventually get into linux kernel developement. Currently it supports:\n+ booting in higher half\n+ paging\n+ memory management\n+ handling IRQs\n+ 80x25 text mode\n+ serial output\n+ PS/2 keyboard\n+ PS/2 mouse\n+ PIC timer\n+ usermode process loading\n+ preemptive multitasking\n+ VBE graphics\n+ window management\n+ custom GUI toolkit\n+ ext2 support\n\nI aim to make the code readable and well-organized. A blog follows the development of this project, here https://jmnl.xyz/, and the [wiki](https://github.com/29jm/SnowflakeOS/wiki) provides more information about the project and its internals.\n\n## Building \u0026 running\n\n### Dependencies\n\nInstall the following packages:\n\n+ `xorriso` for Debian/Ubuntu; `libisoburn` on Archlinux\n+ `grub`\n+ `mtools`\n+ `imagemagick`\n+ `qemu` (recommended)\n+ `bochs` (optional)\n+ `clang` + development packages, e.g. `base-devel` on Archlinux (optional)\n\n### Cross-compiler\n\n#### Building your own\n\nRun\n\n    make toolchain\n\nto build the cross-compiler needed to compile SnowflakeOS. This command will download and run build scripts for `gcc` and `binutils` from GNU FTP servers, and install the cross-compiler in `toolchain/compiler`.\n\n#### Using clang directly\n\nInstead of building your own toolchain, you can compile SnowflakeOS with your system's `clang`: simply uncomment the following group of lines in the main `Makefile`:\n```shell\n# CC=clang\n# LD=ld\n# AR=ar\n# AS=as\n# CFLAGS+=-target i386-pc-none-eabi -m32\n# CFLAGS+=-mno-mmx -mno-sse -mno-sse2\n```\n\n#### Using a preinstalled cross-compiler\n\nIf your distro provides you with a cross compiler, you may want to save time and use it. To do so, you must edit the following variables in the main `Makefile` so that they match the executables of your cross compiler:\n\n    AR=$(HOST)-ar\n    AS=$(HOST)-as\n    LD=$(HOST)-ld\n    CC=$(HOST)-gcc --sysroot=$(SYSROOT) -isystem=/$(INCLUDEDIR)\n\nYou may edit `HOST`, or hardcode the executables names directly.\n\n### Running SnowflakeOS\n\nRun either\n\n    make qemu # or\n    make bochs\n\nto test SnowflakeOS in a VM. See [the edit/debug cycle](https://github.com/29jm/SnowflakeOS/wiki/The-edit-debug-cycle) for more options on how to compile and run SnowflakeOS.\n\nTesting this project on real hardware is possible. You can copy `SnowflakeOS.iso` to an usb drive using `dd`, like you would when making a live usb of another OS, and boot it directly.  \nNote that this is rarely ever tested, who knows what it'll do :) I'd love to hear about it if you try this, on which hardware, etc...\n\n## Contributing\n\nContributions are most welcome, in any form! Consult `CONTRIBUTING.md` and this project's [wiki](https://github.com/29jm/SnowflakeOS/wiki) for guidance.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F29jm%2FSnowflakeOS","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F29jm%2FSnowflakeOS","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F29jm%2FSnowflakeOS/lists"}