Installing the command-line executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install efi-runner

It will make the efi-runner command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall efi-runner uninstalls.

Back to the crate overview.

Readme

`efi-runner`

A runner for EFI executables using QEMU and OVMF.

Prerequisites

You must have QEMU installed, as it is used for emulating a UEFI.

How to Install

To install efi-runner, you must use cargo install on the nightly channel with the bindeps unstable feature enabled:

cargo +nightly install efi-runner -Z bindeps

How to Use

Create a .cargo/config.toml file in your project if it doesn't already exist and add the following:

[target.x86_64-unknown-uefi]
runner = "efi-runner"

After that, you're good to go! efi-runner is configured as your UEFI target runner and whenever you run your project, for example, like so:

cargo run

a QEMU window will open with your program loaded in it.

Screenshot 2023-08-24 at 10 50 14 PM