lumine

cheapskate x86_64/aarch64 UEFI bootloader

config

[!WARNING]

• this rewrite is EXTREMELY incomplete, see master branch for a somewhat working c implementation.
• docs are written primarily for x86_64, just replace BOOTX64 with BOOTAA64 and the rest should be equivalent.

config for lumine is currently written in zig object notation, see default config for reference. see installation for instructions on where to put config file.

compiling

lumine uses the zig build system version 0.16.0, which you can download here.

zig build -Doptimize=ReleaseSafe -Darch=x86_64
# efi executable is now in `zig-out/build/BOOTX64.efi` 

emulation

dependencies like edk2 ovmf firmware are already downloaded as a zig dependency (hmmmm, even if you dont want emulation?)

# starts in serial console
zig build -Darch=x86_64 run

installation

i dont want installation or setup or usage to be something convoluted or "hidden" away like grub does, so that you can literally do it manually and it works fine, or maybe automate finding of installations like grub's os-prober or whatever.

therefore, lumine is only two files:

• efi executable: can be placed anywhere, partition default /EFI/BOOT/BOOTX64.EFI or really any location like /lumine/lumine.efi etc etc, you have the freedom.
• config file: for now, config MUST be placed in /lumine.zon. this WILL change soon however, because i dont like it.

assuming your efi directory is /boot:

cp zig-out/build/BOOTX64.efi /boot/lumine/BOOTX64.EFI
cp config.zon /boot/lumine.zon

now just make a efi boot entry and set BootNext flag to try it out. i wont give you the steps because, well its incomplete as shit and might not work if you smile a little gay, if you really wanna, you might already know how to do it anyway.

license

this project is licensed under BSD-2-Clause license