{"id":13739816,"url":"https://github.com/Bone-Project/BoneOS","last_synced_at":"2025-05-08T19:34:56.118Z","repository":{"id":49474900,"uuid":"62652468","full_name":"Bone-Project/BoneOS","owner":"Bone-Project","description":"💥 BoneOS Kernel and Operating System Source Tree","archived":false,"fork":false,"pushed_at":"2024-08-12T01:09:03.000Z","size":16307,"stargazers_count":130,"open_issues_count":13,"forks_count":29,"subscribers_count":14,"default_branch":"master","last_synced_at":"2024-11-15T09:44:04.856Z","etag":null,"topics":["boneos","c","kernel","operating-system","osdev"],"latest_commit_sha":null,"homepage":"https://amanuel.io/projects/BoneOS","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Bone-Project.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-07-05T16:28:24.000Z","updated_at":"2024-10-25T15:35:15.000Z","dependencies_parsed_at":"2024-08-12T02:28:06.261Z","dependency_job_id":"09229296-105c-449f-a47f-a737f9903e36","html_url":"https://github.com/Bone-Project/BoneOS","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bone-Project%2FBoneOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bone-Project%2FBoneOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bone-Project%2FBoneOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bone-Project%2FBoneOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Bone-Project","download_url":"https://codeload.github.com/Bone-Project/BoneOS/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253135564,"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":["boneos","c","kernel","operating-system","osdev"],"created_at":"2024-08-03T04:00:37.928Z","updated_at":"2025-05-08T19:34:55.536Z","avatar_url":"https://github.com/Bone-Project.png","language":"C","funding_links":[],"categories":["Open Source Operating Systems"],"sub_categories":[],"readme":"# [BoneOS](https://amanuel.io/projects/BoneOS/index.html)\r\n### (Update: Learning Rust, since I will be doing a complete rewrite in Rust. Wish me luck 😭)\r\n\r\n\r\n\u003cp align=\"center\"\u003e\u003ca href=\"https://boneos.org\" target=\"_blank\"\u003e\u003cimg width=\"200\"src=\"https://i.imgur.com/H6ixAr4.png\"\u003e\u003c/a\u003e\u003c/p\u003e\r\n\r\n\r\n\u003cp align=\"center\"\u003e\r\n\r\n\u003ca href='http://docs.boneos.org/en/latest/?badge=latest'\u003e\u003cimg src='https://img.shields.io/badge/docs-latest-brightgreen.svg?style=flat' alt='Documentation Status' /\u003e\u003c/a\u003e\r\n\r\n\u003ca href=\"https://gitter.im/amanuel2/BoneOS?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge\"\u003e\u003cimg src=\"https://badges.gitter.im/amanuel2/BoneOS.svg\"\u003e\u003c/a\u003e\r\n\r\n\u003ca href=\"https://BoneOS.slack.com\"\u003e\u003cimg src=\"https://slack.boneos.org/badge.svg\"\u003e\u003c/a\u003e\r\n\r\n\u003ca href=\"https://zenhub.com\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/ZenHubIO/support/master/zenhub-badge.png\"\u003e\u003c/a\u003e\r\n\r\n\u003ca href=\"https://www.bountysource.com/teams/boneos\"\u003e\u003cimg src=\"https://api.bountysource.com/badge/team?team_id=184475\"\u003e\u003c/a\u003e\r\n\u003ctable\u003e\r\n  \u003ctr\u003e\r\n    \u003cth\u003eRelease Version\u003c/th\u003e\r\n    \u003cth\u003eRelease Date\u003c/th\u003e\r\n    \u003cth\u003eGithub Releases\u003c/th\u003e\r\n    \u003cth\u003eSourceForge\u003c/th\u003e\r\n  \u003c/tr\u003e\r\n\r\n  \u003ctr\u003e\r\n   \u003ctd\u003eV 0.0.1\u003c/td\u003e\r\n   \u003ctd\u003eDec/29/2016\u003c/td\u003e\r\n   \u003ctd\u003e\r\n   \u003ca href=\"https://github.com/Bone-Project/BoneOS/releases/download/v0.0.1/BoneOS.iso\"\u003e\u003cimg src=\"https://img.shields.io/github/downloads/Bone-Project/BoneOS/v0.0.1/BoneOS.iso.svg\"/\u003e\u003c/a\u003e\r\n   \u003c/td\u003e\r\n   \u003ctd\u003e\r\n   \u003ca href=\"https://sourceforge.net/projects/boneproject-boneos/files/Release%20V%200.0.1/BoneOS.iso/download\"\u003e\u003cimg src=\"https://a.fsdn.com/con/app/sf-download-button\"/\u003e\u003c/a\u003e\r\n   \u003c/td\u003e\r\n  \u003c/tr\u003e\r\n  \u003ctr\u003e\r\n   \u003ctd\u003eV 0.0.2\u003c/td\u003e\r\n   \u003ctd\u003eJan/16/2017\u003c/td\u003e\r\n   \u003ctd\u003e\r\n   \u003ca href=\"https://github.com/Bone-Project/BoneOS/releases/download/v0.0.2/BoneOS.iso\"\u003e\u003cimg src=\"https://img.shields.io/github/downloads/Bone-Project/BoneOS/v0.0.2/BoneOS.iso.svg\"/\u003e\u003c/a\u003e\r\n   \u003c/td\u003e\r\n   \u003ctd\u003e\r\n   \u003ca href=\"https://sourceforge.net/projects/boneproject-boneos/files/Release%20v0.0.2/BoneOS.iso/download\"\u003e\u003cimg src=\"https://a.fsdn.com/con/app/sf-download-button\"/\u003e\u003c/a\u003e\r\n   \u003c/td\u003e\r\n  \u003c/tr\u003e\r\n  \u003ctr\u003e\r\n   \u003ctd\u003eV 0.0.3\u003c/td\u003e\r\n   \u003ctd\u003eFeb/05/2017\u003c/td\u003e\r\n   \u003ctd\u003e\r\n   \u003ca href=\"https://github.com/Bone-Project/BoneOS/releases/download/v0.0.3/BoneOS.iso\"\u003e\u003cimg src=\"https://img.shields.io/github/downloads/Bone-Project/BoneOS/v0.0.3/BoneOS.iso.svg\"/\u003e\u003c/a\u003e\r\n   \u003c/td\u003e\r\n   \u003ctd\u003e\r\n   \u003ca href=\"https://sourceforge.net/projects/boneproject-boneos/files/Release%20v0.0.3/BoneOS.iso/download\"\u003e\u003cimg src=\"https://a.fsdn.com/con/app/sf-download-button\"/\u003e\u003c/a\u003e\r\n   \u003c/td\u003e\r\n  \u003c/tr\u003e\r\n\u003c/table\u003e\r\n\r\n\u003ctable\u003e\r\n  \u003ctr\u003e\r\n    \u003cth\u003eBranch\u003c/th\u003e\r\n    \u003cth\u003eStatus\u003c/th\u003e\r\n    \u003cth\u003eMain Developer\u003c/th\u003e\r\n  \u003c/tr\u003e\r\n\r\n   \u003ctr\u003e\r\n    \u003ctd\u003emaster\u003c/td\u003e\r\n    \u003ctd\u003e\r\n    \u003ca href=\"https://travis-ci.org/Bone-Project/BoneOS/branches\"\u003e \u003cimg src=\"https://api.travis-ci.org/Bone-Project/BoneOS.svg?branch=master\"/\u003e\u003c/a\u003e\r\n    \u003c/td\u003e\r\n    \u003ctd\u003e\u003cstrong\u003e\u003ca href=\"https://github.com/Bone-Project\"\u003eBoneOS Community\u003c/a\u003e\u003c/strong\u003e\u003c/td\u003e\r\n  \u003c/tr\u003e\r\n\r\n  \u003ctr\u003e\r\n    \u003ctd\u003eamanuel_dev\u003c/td\u003e\r\n    \u003ctd\u003e\r\n    \u003ca href=\"https://travis-ci.org/Bone-Project/BoneOS/branches\"\u003e \u003cimg src=\"https://api.travis-ci.org/Bone-Project/BoneOS.svg?branch=amanuel_dev\"/\u003e\u003c/a\u003e\r\n    \u003c/td\u003e\r\n    \u003ctd\u003e\u003cstrong\u003e\u003ca href=\"https://github.com/amanuel2\"\u003eamanuel2\u003c/a\u003e\u003c/strong\u003e\u003c/td\u003e\r\n  \u003c/tr\u003e\r\n   \u003ctr\u003e\r\n    \u003ctd\u003edoug_dev\u003c/td\u003e\r\n    \u003ctd\u003e\r\n    \u003ca href=\"https://travis-ci.org/Bone-Project/BoneOS/branches\"\u003e \u003cimg src=\"https://api.travis-ci.org/Bone-Project/BoneOS.svg?branch=doug_dev\"/\u003e\u003c/a\u003e\r\n    \u003c/td\u003e\r\n    \u003ctd\u003e\u003cstrong\u003e\u003ca href=\"https://github.com/doug65536\"\u003edoug65536\u003c/a\u003e\u003c/strong\u003e\u003c/td\u003e\r\n  \u003c/tr\u003e\r\n   \u003ctr\u003e\r\n    \u003ctd\u003eashish_dev\u003c/td\u003e\r\n    \u003ctd\u003e\r\n    \u003ca href=\"https://travis-ci.org/Bone-Project/BoneOS/branches\"\u003e \u003cimg src=\"https://api.travis-ci.org/Bone-Project/BoneOS.svg?branch=ashish_dev\"/\u003e\u003c/a\u003e\r\n    \u003c/td\u003e\r\n    \u003ctd\u003e\u003cstrong\u003e\u003ca href=\"https://github.com/Fortunate-MAN\"\u003eFortunate-MAN\u003c/a\u003e\u003c/strong\u003e\u003c/td\u003e\r\n  \u003c/tr\u003e\r\n\u003c/table\u003e\r\n\r\n\r\n\r\n\u003c/p\u003e\r\n\r\n\r\n\r\n\r\n\u003ch3 color=\"red\"\u003e Current BoneOS Version : V 0.0.2 \u003c/h3\u003e\r\n\r\n\r\n\r\n\u003ca href=\"https://www.gitcheese.com/app/#/projects/fa53637b-26a0-49e0-b836-ae4b5c63adc8/pledges/create\"\u003e\u003cimg src=\"https://api.gitcheese.com/v1/projects/fa53637b-26a0-49e0-b836-ae4b5c63adc8/badges?type=1\"/\u003e\u003c/a\u003e\r\n\r\n\r\n\r\n\r\n\r\n\r\n### [BoneOS Issues](https://github.com/Bone-Project/BoneOS/issues)\r\n\r\n\r\nWelcome! This is the official and main repository of BoneOS. This project is currently in high active development ,\r\nand is predominately written in C ofcourse some parts such as  hardware communication, scripting, building, etc ...will use\r\nother languages.\r\nIf you find any issue using this OS please request an issue [**here**](https://github.com/Bone-Project/BoneOS/issues)!\r\nIf you have any contributions or pull requests, which will be highly appreciated, please issue a pull request\r\n[**here**](https://github.com/Bone-Project/BoneOS/pulls)!\r\n\r\n# WARNINGS\r\n---\r\n\r\n - Installing VirtualBox on Ubuntu may lead to problems.\r\n\r\n\r\n# Discussions\r\n---\r\n\r\nAny Questions, Comments, Ideas, Feature Requests, etc. may be brought up [here](https://github.com/Bone-Project/BoneOS/issues).\r\n\r\n# Installation\r\n---\r\n\r\nThere are two ways to install BoneOS: one for the normal user to get it into his Virtual Machine and the other for the developer who want to contribute (building from source).\r\n\r\n#### Normal Installation (For user)\r\n  To install a spsecific version , go to the top of readme where you will see the version number listed as well as installing the Image File via SourceForge or Github Releases. Choose whichever you would like and when you finish installing the ISO(Image File) plug it into your Virtual Machine. [**here**](https://www.youtube.com/watch?v=rBjlaEAzUZo\u0026feature=youtu.be) is a video showing how to do this using VirtualBox as the Virtual Machine Emulator. You can download Virtual Box [**here**](https://www.virtualbox.org/). [Here](https://www.youtube.com/watch?v=yDiwl6AxNrc\u0026feature=youtu.be) is a video showing how to get it in VMWare. VMWare is paid , there if a free trial though. You can get more Information at our Offical Download Page [here](https://boneos.org/download.html).\r\n\r\n#### Nightly Builds (For Developer Or Normal User)\r\n\r\nYou can  get the nightly builds for the latest updated iso for the master branch [here](https://bintray.com/boneos/BoneOS/download_file?file_path=BoneOS-master.iso) .\r\n\r\n#### Building From Source (For developer)\r\n\r\n First make sure you have a Ubuntu Terminal (If you are on Windows, use the new Linux Subsystem Feature). Then download the dependencies using `bash setup.sh`. Then compile BoneOS using `make`. Now that you have qemu after you executed `setup.sh` , you can go ahead and run on qemu using `make qemu_compile` for running the binary or `make qemu_iso` to run the actual Image File(.ISO).\r\n\r\n#### Cloud9 Collaboration (For Developer)\r\n\r\n You can collaborate with the Main BoneOS Developer in Cloud9. Cloud9 Is an Online IDE , with an Ubuntu Terminal. We use Cloud9IDE Terminal + NoVNC to make this possible.\r\n the workspace is located [here](https://ide.c9.io/amanuel2/osdev) . You can learn more [here](https://community.c9.io/t/cant-install-grub/11653/5?u=phpcoder231).\r\n\r\n If you want to setup NoVNC Server once you are in an Cloud9IDE You can use the command\r\n\r\n ```sh\r\n make no_vnc\r\n ```\r\n\r\n#### Extra Options (For Developer)\r\n\r\n There are extra options when building(`make`ing) , this OS. You can set the compiler instead of the default\r\n gcc(`$(CC)`) like so :\r\n\r\n ```sh\r\n  $ CC=clang make #If you want to run via clang\r\n  $ CC=gcc-5 make #If you want to run via GCC Version 5\r\n  $ ./configure --cc=gcc-5 \u0026\u0026 make # Optionally use the configure script to store variable permanently\r\n ```\r\n\r\n You can see more in [Docs/Configuration](https://docs.boneos.org/en/latest/Configuration/Configuration/)\r\n\r\n#### More Info(For Developer)\r\nFor more information, go [here](https://docs.boneos.org) for documentation.\r\n\r\n# Directory Structure\r\n----\r\nOur directory structure currently is as follows:\r\n\r\n- ***docs*** : Documentation for BoneOS\r\n- ***apps*** : Applications\r\n   - ***term*** : Terminal\r\n- ***.github*** : Github related files.\r\n   - ***ISSUE_TEMPLATE.md*** : Github Issues Template\r\n- ***arch*** : Architecture Dependant Codes\r\n   - ***@(ARCH)*** : Architecture name.\r\n     - ***boot***: GRUB Bootloader information\r\n       - ***multiboot***: Grub Multiboot information\r\n     - ***drv***  : Device Drivers for @(ARCH) are located here.\r\n     - ***io*** : I/O Software Code\r\n     - ***link***: Where the linker is located.\r\n     - ***init***: Main kernel function getting called by GRUB Bootloader\r\n  - ***shared*** : Shared piece of code between Proccecor Families\r\n     - ***x86*** : Shared piece of code for x86 family\r\n- ***bin*** : Non Adminstrator Terminal Commands\r\n- ***sbin*** : Adminstrator Terminal Commands\r\n- ***config*** : Configuration Files\r\n- ***hdd*** : Default files on first time use\r\n- ***platform*** : Platform Dependant Code\r\n   - ***pc*** : PC Platform\r\n- ***libc***: C Library constructed and used by BoneOS, non-archecture and non-platform dependant code.\r\n- ***utils***: Utilities for devs.\r\n   - ***cross_compiler***: Script for installing the cross compiler\r\n   - ***no_vnc***: Setup No_vnc server in Cloud9IDE\r\n   - ***watch.sh*** : Nodemon like script\r\n- ***include***: All Include Files(.h).\r\n- ***var*** : Common Variables used across the system.\r\n\r\n# Documentation\r\n ---\r\nYou can take a look at the Documentation online hosted by gitbook [**here**](https://docs.boneos.org). Documentation are for presistant information , not code details.\r\n\r\n# Architectures\r\n---\r\nArchitecture          |   Status    | Plan to support |\r\n------------- | ------------- | -----------|\r\nx86(32 BIT) |    Ready   |  Already Supported        |\r\nx64| On Progress  |    Currently updating to support this architecture       |\r\nPowerPC| Unavailable  |   Yes, in later releases       |\r\nArm| Unavailable   |    Yes, in later releases       |\r\nMIPS | Unavailable|     Yes, in later releases     |\r\n\r\nif there are architectures you want BoneOS to support , please request an issue to talk about it.\r\n\r\n\r\n# FAQ\r\n---\r\n\r\n1) **What is BoneOS Goal?**\r\n Our goal is to make an Operating System for 'Everyone'. Ranging from Programmers\r\n to Normal Users. We dont believe the \"OS Problem\" is solved by either Popular\r\n Operating Systems such as Windows, Mac OSX or even kernels such as Linux.\r\n\r\n2) **Any new features?**\r\n We have some ideas in mind. But it will be a long way until we start adding\r\n new feautres, as we are just starting in the osdev world :).\r\n\r\n3) **Need Help?**\r\n Absolutely! Any help would be appreciated! To get to us, either request an\r\n issue or check ask a question: https://github.com/Bone-Project/BoneOS/issues\r\n\r\n# License\r\n---\r\n\r\nBoneOS is Licensed under the GPLv3 License.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBone-Project%2FBoneOS","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FBone-Project%2FBoneOS","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBone-Project%2FBoneOS/lists"}