README.md

July 5, 2026 ยท View on GitHub

efimux banner

efimux is an EFI application for booting other EFI applications. an efi multiplexer, if you will!

Built With Ratatui

https://github.com/user-attachments/assets/c37e6d62-5e2a-4e62-86b2-3bcd2e930065

Installation and usage

Based on https://rust-osdev.github.io/uefi-rs/tutorial/hardware.html

  1. Connect a USB drive (we will erase all of its data!).

  2. Find its device path, e.g. via lsblk.

  3. Create the GPT and correct partition layout for EFI, example using sgdisk:

    sgdisk \
    --clear \
    --new=1:1M:10M \
    --typecode=1:C12A7328-F81F-11D2-BA4B-00A0C93EC93B \
    /path/to/usb_drive

  4. Format the partition as FAT:

    mkfs.fat /path/to/usb_drive_partition

  5. Mount the partition:

    mount --mkdir /path/to/usb_drive_partition /mnt/usb

  6. Copy in efimux.efi as efi/boot/bootx64.efi:

    mkdir -p /mnt/usb/efi/boot/
cp efimux.efi /mnt/usb/efi/boot/bootx64.efi

  7. Done! Now you are ready to boot from the USB.

Disclaimer

No artificial intelligence was used in the making of this.

brainmade