ratatuefi 0.1.1

<div align="center">

![ratatuefi](./media/banner.svg)
_Zero-bloat Ratatui in UEFI, no OS_

<https://github.com/user-attachments/assets/338462fb-39e2-458e-b789-f591abd682b3>

<https://github.com/user-attachments/assets/9c12cd86-6aef-4f9b-9006-e8e9d527dcc2>

</div>

## Running in QEMU

1. Install packages:

    ```sh
    pacman -S qemu-system-x86_64 edk2-ovmf
    ```

   (optionally, install some graphics backend (recommend sdl+opengl), but you can also VNC into the VM)

    ```sh
    pacman -S qemu-ui-sdl qemu-ui-opengl
    ```

2. Create virtual EFI layout

    ```sh
    just create-virtual-uefi-layout
    ```

   then build and symlink the `.efi` in:  
   (`<EFI>` is something like `./target/x86_64-unknown-uefi/debug/<PACKAGE-NAME>.efi`)

    ```sh
    ln -sf <EFI> esp/efi/boot/bootx64.efi
    ```

3. Start QEMU

    ```sh
    just qemu
    ```

## Running on a physical machine

> from <https://rust-osdev.github.io/uefi-rs/tutorial/hardware.html>

Connect a USB drive. Follow steps below.

```sh
# Create the GPT, create a 9MB partition starting at 1MB, and set the
# partition type to EFI System.
sgdisk \
    --clear \
    --new=1:1M:10M \
    --typecode=1:C12A7328-F81F-11D2-BA4B-00A0C93EC93B \
    /path/to/disk

# Format the partition as FAT.
mkfs.fat /path/to/disk_partition

# Mount the partition.
mount --mkdir /path/to/disk_partition /mnt/ratatuefi

# Copy in the boot executable.
cp -rL esp/efi /mnt/ratatuefi/

# Eject the USB drive
eject /path/to/disk
```

> [!IMPORTANT]
> disable secure boot on machine before trying to boot

try booting it!

## Ideas for improving

<s>

it is slow as hell to draw. could possibly be improved by

- adding a buffer, and rendering full lines? currently we are rawdoggin character-for-character.
- switching to manual VGA graphics (use mousefood?)

</s>

was fixed by using `-display sdl,gl=on`!
somehow running without OpenGL makes it really slow!