https://github.com/v0idzdev/open-jinx
Jinx OS is a retro themed command line operating system for x86_64 architectures.
https://github.com/v0idzdev/open-jinx
assembly c command-line docker linux os retro
Last synced: 3 months ago
JSON representation
Jinx OS is a retro themed command line operating system for x86_64 architectures.
- Host: GitHub
- URL: https://github.com/v0idzdev/open-jinx
- Owner: v0idzdev
- License: gpl-3.0
- Created: 2022-04-30T16:49:32.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2022-05-07T15:41:04.000Z (about 4 years ago)
- Last Synced: 2025-08-28T13:31:09.436Z (10 months ago)
- Topics: assembly, c, command-line, docker, linux, os, retro
- Language: Assembly
- Homepage:
- Size: 4.05 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Jinx OS
Jinx is a basic operating system built from scratch.
## Why Did I Decide to Create an OS?
I decided to start this project to learn how to make an OS. Hence, this software is **not** intended to be used by end users - at least, not unless it becomes stable and featureful enough for that to be possible.
A small disclaimer, most of the code in this repository has been copied, or at least heavily influenced by, various tutorials. After all, I'm trying to learn the ropes as an operating system developer, and am a complete beginner to this area of software engineering.
## How Can I Use Jinx OS?
At the moment, Jinx is just a minimal bootable OS skeleton. When Jinx becomes somewhat featureful, I will add download links for ISO files. Nevertheless, you can run Jinx on Linux in a VM (I will use **QEMU** as an example) like this:
#### Clone the repository
```bash
git clone https://github.com/matthewflegg/open-jinx.git
cd open-jinx
```
#### Then, install QEMU:
```bash
sudo apt install qemu # Ubuntu, Debian, etc.
```
```bash
sudo dnf in qemu # Fedora, RHEL, etc.
```
```bash
sudo pacman -S qemu # Arch, Manjaro, etc.
```
#### Run Jinx OS
```bash
chmod +x scripts/run.sh
./scripts/run.sh
```
## References/Tutorials I Followed
Below, I've listed all of the tutorials that I used to create Jinx OS.
* **[Daedelus | Making an OS | YouTube](https://www.youtube.com/watch?v=MwPjvJ9ulSc)**
* **[Poncho | OS Dev S2 | YouTube](https://www.youtube.com/playlist?list=PLxN4E629pPnJxCQCLy7E0SQY_zuumOVyZ)**
* **[nanobyte | Building an OS | YouTube](https://www.youtube.com/watch?v=9t-SPC7Tczc&list=PLFjM7v6KGMpiH2G-kT781ByCNC_0pKpPN)**