{"id":18348086,"url":"https://github.com/shawnanastasio/shawnos","last_synced_at":"2026-03-02T13:37:20.651Z","repository":{"id":84515367,"uuid":"55174271","full_name":"shawnanastasio/ShawnOS","owner":"shawnanastasio","description":"A Basic x86 Operating System/Kernel","archived":false,"fork":false,"pushed_at":"2019-01-26T02:22:40.000Z","size":2934,"stargazers_count":48,"open_issues_count":2,"forks_count":6,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-07-11T02:53:41.733Z","etag":null,"topics":["hobby","kernel","operating-system","osdev","x86"],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shawnanastasio.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":"2016-03-31T18:39:02.000Z","updated_at":"2025-06-21T03:56:23.000Z","dependencies_parsed_at":null,"dependency_job_id":"c9438df1-4ab5-405e-8f6b-dfaf71b010ff","html_url":"https://github.com/shawnanastasio/ShawnOS","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/shawnanastasio/ShawnOS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shawnanastasio%2FShawnOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shawnanastasio%2FShawnOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shawnanastasio%2FShawnOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shawnanastasio%2FShawnOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shawnanastasio","download_url":"https://codeload.github.com/shawnanastasio/ShawnOS/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shawnanastasio%2FShawnOS/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30004954,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-02T12:19:43.414Z","status":"ssl_error","status_checked_at":"2026-03-02T12:19:02.215Z","response_time":60,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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","kernel","operating-system","osdev","x86"],"created_at":"2024-11-05T21:16:18.670Z","updated_at":"2026-03-02T13:37:20.644Z","avatar_url":"https://github.com/shawnanastasio.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"ShawnOS\n======\n\nShawnOS is an Operating System/Kernel meant to help learn the fundamentals of Operating System development, primarily on Intel x86-based architectures.\n\nThe project is very much a work-in-progress at this point and many design decisions regarding the OS are yet to be made. Eventually, the project aims to reach a basic level of usability, with a functional console environment and C compiler.\n\nAll code is licensed under the GNU GPL v3 unless explicitly stated elsewhere.\n\nBuilding\n------\nIn order to build and run ShawnOS, a gcc cross-compiling toolchain must be present for the desired target (currently i686-elf is only supported).\n\nThe OSDev Wiki has a tutorial on how to create the required toolchain for Linux, OS X, and Windows [here](http://wiki.osdev.org/GCC_Cross-Compiler).\n\nIn addition to the tools mentioned in the OSDev wiki, you will also need a few more packages. \n\n- nasm\n- xorriso\n- mtools\n- grub-pc (Debian/Ubuntu only)\n\nThese are available in most Linux distributions' package managers.\n```\n# Debian/Ubuntu\n$ sudo apt-get install nasm xorriso mtools grub-pc-bin\n\n# Fedora\n$ sudo dnf install nasm xorriso mtools \n\n# Arch Linux\n$ sudo pacman -S nasm xorriso mtools\n```\n\n\nOnce you have set up the necessary toolchain, you must update the `PREFIX` and `PATH` variables in `env.sh` to reflect its location.\n\nExample:\n```\nexport PREFIX='$HOME/opt/cross'\nexport TARGET=i686-elf\nexport PATH='$PREFIX/bin:$PATH'\n```\n\nOnce you have completed this, simply run the following to load the variables:\n```\n$ source env.sh\n```\n\n\nNow you may build an ISO image of the OS:\n```\n$ make iso\n```\n\nIf you have qemu installed for the proper architecture, you can also run ShawnOS in a virtual machine:\n```\n$ make qemu\n```\n\nGoals\n------\n\nThe project eventually aims to provide a basic usable user space with console utilities and a C compiler.\n\nResources\n------\nMuch of the code from ShawnOS is adapted from or inspired by the following resources:\n\n[The OSDev Wiki](https://wiki.osdev.net)\n\n[Bran's Kernel Development Tutorial](http://www.osdever.net/bkerndev/Docs/title.htm)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshawnanastasio%2Fshawnos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshawnanastasio%2Fshawnos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshawnanastasio%2Fshawnos/lists"}