boot-logo

A small command-line tool for extracting and replacing the boot logo embedded in OVMF firmware files.

Features ✨

• Replaces embedded logos with a custom image
• Supports BMP, PNG, JPG and JPEG images
• Preserves all unchanged firmware sections
• Extracts bitmaps from firmware and FFS files
• Available for both AMD64 and ARM64 platforms

Usage

Replace the boot logo

boot-logo logo.png firmware.fd

The input image may be a BMP, PNG, JPG or JPEG file.

By default, the supplied firmware file is modified in place.

To write the modified firmware to a different file instead:

boot-logo replace logo.jpg firmware.fd --output modified.fd

Extract the boot logo

boot-logo extract firmware.fd

By default, the extracted logo is written to:

firmware.fd.logo.bmp

Specify a different output path:

boot-logo extract firmware.fd --output logo.bmp

A logo can also be extracted from a standalone FFS file:

boot-logo extract LogoDxe.ffs

Options

-o, --output <path>  Write to a different output path
-h, --help           Show usage information
-v, --version        Show version information

Firmware support

The tool supports complete OVMF firmware images and standalone FFS files containing the standard TianoCore LogoDxe file:

F74D20EE-37E7-48FC-97F7-9B1047749C69

The tool expects exactly one valid bitmap inside this file. Firmware that does not match this layout is rejected instead of being modified blindly.

Installation

Download the binary for your architecture from the latest release:

boot-logo-amd64.bin
boot-logo-arm64.bin

Make it executable:

chmod +x boot-logo-amd64.bin

Optionally install it system-wide:

sudo install -m 755 boot-logo-amd64.bin /usr/local/bin/boot-logo

Stars 🌟