{"id":13739798,"url":"https://github.com/dthain/basekernel","last_synced_at":"2025-10-24T22:00:52.622Z","repository":{"id":48873418,"uuid":"48499743","full_name":"dthain/basekernel","owner":"dthain","description":"A simple OS kernel for research, teaching, and fun.","archived":false,"fork":false,"pushed_at":"2024-04-19T18:06:23.000Z","size":3394,"stargazers_count":803,"open_issues_count":20,"forks_count":109,"subscribers_count":23,"default_branch":"master","last_synced_at":"2024-11-15T09:44:03.702Z","etag":null,"topics":[],"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-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dthain.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":"2015-12-23T16:17:36.000Z","updated_at":"2024-11-14T09:16:11.000Z","dependencies_parsed_at":"2024-11-15T09:44:19.739Z","dependency_job_id":null,"html_url":"https://github.com/dthain/basekernel","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dthain%2Fbasekernel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dthain%2Fbasekernel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dthain%2Fbasekernel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dthain%2Fbasekernel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dthain","download_url":"https://codeload.github.com/dthain/basekernel/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253135554,"owners_count":21859666,"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":[],"created_at":"2024-08-03T04:00:37.748Z","updated_at":"2025-10-24T22:00:52.615Z","avatar_url":"https://github.com/dthain.png","language":"C","funding_links":[],"categories":["OS","Open Source Operating Systems"],"sub_categories":["ESP8266"],"readme":"# The Basekernel Operating System Kernel\n\nBasekernel is a simple operating system kernel for research, teaching, and fun.\n\nBasekernel is *not* a complete operating system, but it is a starting\npoint for those who wish to study and develop new operating system code.\nIf you want to build something *different* than Windows, Linux, or Multics,\nBasekernel may be a good place to try out your new ideas.\n\nBasekernel can boot an Intel PC-compatible virtual machine in 32-bit protected\nmode, with support for VESA framebuffer graphics, ATA hard disks, ATAPI optical\ndevices, process management, memory protection, simple graphics, and basic filesystem.\nFrom there, it's your job to write user-level programs and expand the system.\n\nTo be clear, this is raw low-level code, not a production system.\nIf you want to hack code and learn about operating system, you will like Basekernel.\nIf you are looking for a new OS to run on your laptop, then this is not what you want.\n\nThis project is led by Prof. Douglas Thain at the University of Notre Dame.\nA variety of students have contributed to the code, including\nJack Mazanec, Douglas Smith, Ethan Williams, Jon Westhoff, and Kevin Wern.\n\nTo learn more, see the [Basekernel Wiki](https://github.com/dthain/basekernel/wiki).\n\n## Quick Start Instructions\n\nIf you are building on a Linux-X86 machine\nand have the QEMU virtual machine installed:\n\n```\ngit clone https://github.com/dthain/basekernel\ncd basekernel\nmake\nqemu-system-i386 -cdrom basekernel.iso\n```\n\nAnd you should see something like this:\n\n\u003cimg src=screenshot.png align=center\u003e\n\nAfter some initial boot messages, you will see the kernel shell prompt.\nThis allows you to take some simple actions before running the first\nuser level program.  To automatically boot the first available filesystem,\nwhether on cdrom or harddisk, run \u003ctt\u003eautomount\u003c/tt\u003e:\n\n\u003cpre\u003e\nautomount\n\u003c/pre\u003e\n\nThen use the \u003ctt\u003elist\u003c/tt\u003e command to examine the root directory:\n\n\u003cpre\u003e\nlist /\n\u003c/pre\u003e\n\nAnd use the \u003ctt\u003erun\u003c/tt\u003e command to run a program.\nFor example, \u003ctt\u003e/bin/manager.exe\u003c/tt\u003e runs a simple\nfour-pane window manager with several tasks in parallel.\n(Use TAB to switch focus between programs, and tilde\nto cancel out of the window manager.)\n\n\u003cpre\u003e\nrun /bin/manager.exe\n\u003c/pre\u003e\n\n\u003cimg src=screenshot-windows.png align=center\u003e\n\nPress TAB to change the focus between windows,\nand you can interact with each process in turn.\n\n## Cross-Compiling Instructions\n\nIf you are building on any other type of machine,\nyou will probably need to build a cross-compiler\nusing `build-cross-compiler.sh` and then edit\n`Makefile.config` to use the cross compiler binaries,\nthen execute `make` to create `basekernel.iso`\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdthain%2Fbasekernel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdthain%2Fbasekernel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdthain%2Fbasekernel/lists"}