joexbayer/RetrOS-32: A x86 32bit Hobby Operatingsystem with graphics, multitasking, networking and 32bit C-Compiler for i386 architecture.

32bit Hobby Operatingsystem with graphics, multitasking and networking!

Started: 12.05.2022

(back to top)

There are 3 default users: system, admin and guest. The password for admin is ‘admin’, while guest has no password.
Currently there is no difference between admin and guest.

You can create a user with the ‘admin’ command:

admin create username> password>

This project is built with C & Assembly for the kernel, utilities and build system. C++ for userspace applications and Make for compilation.
Docker used for crossplatform compilation.

(back to top)

Tested on:
Lenovo x240,
Asus Eee PC series,
Dell Optiplex 780,
Samsung N150 Plus,
Samsung NP-NC10,
IBM Thinkpad a21p

Crossplatform: Docker to compile the image file and QEMU for emulation.
For native compilation you will need:

• i386-elf-gcc, i386-elf-ld and i386-elf-g++ for MacOS.
• build-essential and gcc-multilib for Linux / WSL (ubuntu)
• Also need: grub2, xorriso and xxd (for using Grub as bootloader)

To compile the kernel and its needed programs you simply need to run make img and make qemu to open QEMU

1. Clone the repo

   git clone https://github.com/joexbayer/RetrOS-32.git

2. Check that all dependencies are installed (Only for debian based distros)

3. Initialize Git submodules (C-Compiler)

   git submodule update --init --recursive

4. Compile and create image

5. Launch QEMU

6. Use GRUB (Optional)

Currently MacOS cannot natively compile the build tools as they depend on 32bit x86 code.
Docker is the simplest way if you still wish to compile the operating system.

1. Clone the repository

   git clone https://github.com/joexbayer/RetrOS-32.git

2. Initialize Git submodules (C-Compiler)

   git submodule update --init --recursive

3. Build using Docker

   docker-compose up --build

Use Docker (see MacOS section) or WSL (see Linux section).

(back to top)

To run RetrOS-32:

• http://copy.sh/v86/ : Upload .img file as Hard disk image.
• QEMU: make qemu or qemu-system-i386
• Real hardware: Burn .iso file to USB or CD (Use a GRUB iso)

(back to top)

NETOS - Project
├── Dockerfile 
├── LICENSE.txt
├── Makefile
├── apps (userspace applications)
│   ├── Makefile
│   ├── 
│   ├── libcore.a
│   ├── libgraphic.a
│   ├── libnet.a
│   ├── readme.md
│   └── utils
│       └── *.cpp
├── bin 
│   └── *.o
├── boot (custom bootloader)
│   ├── bootloader.s
│   └── multiboot.ld
├── docker-compose.yml
├── docs (documentation)
│   ├── *.md
├── drivers (kernel drivers)
│   └── *.c
├── fs (filesystem)
│   ├── Makefile
│   ├── bin
│   └── *.c
├── graphics
│   └── *.c
├── include
│   ├── arch
│   │   └── *.h
│   ├── fs
│   │   └── *.h
│   ├── gfx
│   │   └── *.h
│   ├── lib
│   │   └── *.h
│   ├── net
│   │   └── *.h
│   └── *.h
├── kernel (main kernel source files)
│   ├── arch
│   │   └── *.c
│   ├── kthreads
│   │   └── *.c
│   └── *.c
├── legacy (old code)
├── lib (libraries)
│   └── *.c
├── net (networking code)
│   └── *.c
├── readme.md
├── rootfs (root filesystem for the OS)
├── tests (testing code)
│   ├── Makefile
│   ├── bin
│   ├── *_test.c
│   └── readme.md
└── tools (build tools)
    ├── scripts
    └── bin
        └── *.c

• Custom Bootloader & GRUB compatible
• Stage 2 bootloader
• Wallpapers
• Mountable image
• Users
• Multi-threaded pre-emptive scheduling
• GDT & TSS kernel / userspace separation
• Interrupt handling
• PS/2 Keyboard & Mouse, PIT, VESA (640x480x8), RTC, Serial drivers, E1000
• PCI.
• 8Bit RGB to 8Bit VGA
• Filesystem
• Textmode VGA only
• Networkstack
• ATA IDE Driver
• Memory
• Graphics
• Terminal, Window Server, Process Informtaion, Finder.
• Library (printf, memcpy, etc)
• IPC
• System calls
• C Compiler / interpreter to bytecode
• Custom VM to run bytecode.
• Editor with Syntax Highlighting
• Calculator
• 3D Game
• Snake game (Textmode only)
• Userspace threads (shared virtual memory)
• Remote virtual terminal over TCP
• LZ compression library
• Tools

See the open issues for a full list of proposed features (and known issues).

(back to top)

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Joe Bayer

Project Link: https://github.com/joexbayer/RetrOS-32

(back to top)

Use this space to list resources you find helpful and would like to give credit to. I’ve included a few of my favorites to kick things off!

(back to top)

Keep your files stored safely and securely with the SanDisk 2TB Extreme Portable SSD. With over 69,505 ratings and an impressive 4.6 out of 5 stars, this product has been purchased over 8K+ times in the past month. At only $129.99, this Amazon’s Choice product is a must-have for secure file storage.

Help keep private content private with the included password protection featuring 256-bit AES hardware encryption. Order now for just $129.99 on Amazon!

Help Power Techcratic’s Future – Scan To Support

If Techcratic’s content and insights have helped you, consider giving back by supporting the platform with crypto. Every contribution makes a difference, whether it’s for high-quality content, server maintenance, or future updates. Techcratic is constantly evolving, and your support helps drive that progress.

As a solo operator who wears all the hats, creating content, managing the tech, and running the site, your support allows me to stay focused on delivering valuable resources. Your support keeps everything running smoothly and enables me to continue creating the content you love. I’m deeply grateful for your support, it truly means the world to me! Thank you!