🌟 AuriOS

          .**.
         .=###.
        .==.##%
       .===.###
      .=====###.
     .======.###
    .======..###.
   .===.     ###.
             .***

AuriOS is a simple, educational operating system kernel built from scratch for x86 architecture. It's designed to help understand the fundamentals of operating system development, including memory management, interrupt handling, and hardware interaction.

This project demonstrates low-level system programming concepts and serves as a learning platform for OS development enthusiasts.

• 🔧 Core System Components

  • Global Descriptor Table (GDT) initialization
  • Interrupt Descriptor Table (IDT) with ISR handlers
  • Programmable Interrupt Controller (PIC) remapping
  • Custom bootloader

• 💾 Memory Management

  • Basic memory initialization
  • Dynamic memory allocation (malloc)
  • Memory utility functions

• ⚙️ Hardware Drivers

  • Keyboard driver with input handling
  • Programmable Interval Timer (PIT)
  • VGA text mode terminal

• 🖥️ User Interface

  • Interactive shell
  • Terminal with color support
  • Command-line interface

• 🛠️ Development Tools

  • Comprehensive Makefile
  • QEMU integration for testing
  • ISO generation for bootable media

Thank to all the contributors, you are the flame burning in our heart ❤️

Profile	GitHub	Role
	nymii	Founder & Maintainer
	Maddie	Co-Founder & Maintainer
	pepedinho	Co-Maintainer
	switchcodeur	Contributor
	proxzr	Contributor
	Aomitsu	Contributor
	Ivy-js	Contributor
	gittihub-jpg	Contributor
	Jesuiskoriel	Contributor
	Kudasai	Contributor & Bug Hunter
	frenchcast1234	Contributor

Before building AuriOS, ensure you have the following tools installed:

• Cross-compiler: i686-elf-gcc (GCC configured for i686-elf target)
• Assembler: nasm (Netwide Assembler)
• Linker: i686-elf-ld
• Emulator: qemu-system-i386 for arm - or qemu-system-x86_64 for x86
• Build tools: make, grub-mkrescue (for ISO creation)
• Additional: xorriso, mtools (for ISO generation)

git clone https://github.com/Auri-OS/AuriOS.git
cd AuriOS

make install

Note: For detailed installation instructions for your platform, see Requirements & environment from the documentation.

make all

This will:

• Compile all C source files
• Assemble all assembly files
• Link everything into a kernel binary
• Generate a bootable ISO image

make run

❯ make
======================= AuriOS Makefile =======================

Installation (requires admin rights):
  make install - Install dependencies (cross-platform)

Compilation targets:
  make all            - Build everything
  make iso            - Build OS binary and create bootable ISO
  make iso-debug      - Build bootable ISO with Test Mode enabled (serial output)

Execution targets:
  make run            - Build and run in QEMU (x86_64)
  make clean          - Remove all build artifacts

===============================================================

Once AuriOS boots, you'll see the initialization sequence followed by an interactive shell. The shell supports keyboard input, command history and tab-completion.

AuriOS/
├── scripts/
│   └── install.sh
├── src/
│   ├── boot/
│   │   └── loader.s
│   ├── commands/
│   │   ├── crash.c
│   │   ├── echo.c
│   │   ├── fetch.c
│   │   ├── help.c
│   │   ├── memdump.c
│   │   ├── memtest.c
│   │   ├── mia.c
│   │   ├── peek.c
│   │   ├── poke.c
│   │   ├── poweroff.c
│   │   ├── reboot.c
│   │   ├── setprompt.c
│   │   └── uptime.c
│   ├── cpu/
│   │   ├── gdt.c
│   │   ├── gdt_flush.asm
│   │   ├── idt.c
│   │   ├── idt_flush.asm
│   │   ├── irq.c
│   │   ├── isr.c
│   │   ├── isr_stubs.asm
│   │   └── pic.c
│   ├── drivers/
│   │   ├── framebuffer.c
│   │   ├── keyboard.c
│   │   ├── serial.c
│   │   └── timer.c
│   ├── include/
│   │   ├── ansi.h
│   │   ├── colors.h
│   │   ├── commands.h
│   │   ├── fetch.h
│   │   ├── font.h
│   │   ├── framebuffer.h
│   │   ├── gdt.h
│   │   ├── history.h
│   │   ├── idt.h
│   │   ├── integer.h
│   │   ├── io.h
│   │   ├── isr.h
│   │   ├── keyboard.h
│   │   ├── log.h
│   │   ├── memory.h
│   │   ├── mm.h
│   │   ├── multiboot.h
│   │   ├── pic.h
│   │   ├── serial.h
│   │   ├── shell.h
│   │   ├── string.h
│   │   ├── terminal.h
│   │   ├── timer.h
│   │   └── types.h
│   ├── kernel/
│   │   ├── ainsi.zig
│   │   ├── history.c
│   │   ├── kernel.c
│   │   ├── log.c
│   │   ├── shell.c
│   │   └── terminal.c
│   ├── lib/
│   │   ├── integer.c
│   │   ├── memory.c
│   │   └── string.c
│   └── mm/
│       ├── mmu.zig
│       └── pmm.zig
├── tests/
│   └── integrations
│       ├── error_handling.yml
│       ├── memory_tools.yml
│       ├── shell.yml
│       ├── timer_flags.yml
│       └── walkman.yaml
├── LICENSE
├── linker.ld
├── Makefile
├── README.md
└── walkman.yaml

Check out our full documentation !

• Requirements & environment - Detailed setup instructions
• Contributing Guidelines - How to contribute
• Building & running - Development environment setup

Contributions are welcome! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Please read Contributing Guidelines for details on our code of conduct and development process.

This project is licensed under the MIT License - see the LICENSE file for details.

• The OSDev community for extensive documentation
• The creators of GRUB for the bootloader
• All contributors who have helped improve AuriOS

Project Link: https://github.com/Auri-OS/AuriOS

Discord Server: AuriOS Discord

X: @tryAuriOS

Website: auri-os.org

Documentation: auri-os.org/docs

Taskboard: @Auri-OS 's Todo-List !