https://github.com/shikaan/x86-tiny-os
Tiny x86 real-mode OS
https://github.com/shikaan/x86-tiny-os
assembly retrocomputing x86
Last synced: about 1 year ago
JSON representation
Tiny x86 real-mode OS
- Host: GitHub
- URL: https://github.com/shikaan/x86-tiny-os
- Owner: shikaan
- License: mit
- Created: 2025-04-03T13:10:17.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-05T14:17:25.000Z (about 1 year ago)
- Last Synced: 2025-04-05T15:25:00.262Z (about 1 year ago)
- Topics: assembly, retrocomputing, x86
- Language: Assembly
- Homepage:
- Size: 7.81 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
x86 Tiny OS
---
This repository contains a tiny OS that can be run on x86 hardware.
## tl;dr
* Tiny real-mode OS in 16 bits x86 assembly;
* It's written as a bootloader. It's only 510 bytes in total;
* It's a toy. Don't use it for anything serious, please.
## Dependencies
* [GNU make](https://www.gnu.org/software/make/)
* [nasm](https://www.nasm.us)
* [bochs](https://bochs.sourceforge.io)
### MacOS
Using Homebrew
```sh
brew install nasm
brew install bochs
```
### Linux
Using your local package manager, for example in Debian
```sh
apt install nasm bochs
```
Please refer to the respective packages pages should you experience any problem.
## Run locally
```sh
make start
```
## Build locally
```sh
make boot.o
```
## Use it on a real device
For example using `dd`
```sh
sudo dd if=boot.o of=/dev/YOUR_DEVICE bs=512 count=1
```