XeroLinux Limine/SecureBoot Enabler

A guided GUI that migrates an installed XeroLinux system from GRUB to Limine and enables Secure Boot Support via sbctl.

⚠️ Use At Your Own Risk

This tool replaces your bootloader and changes Secure Boot enrollment at the firmware level. Turn Secure Boot off and clear any existing keys before proceeding. If interrupted or misconfigured, your system can become unbootable and may need manual recovery from a live USB. Backups are strongly recommended.

Features

• Applies a XeroLinux boot splash wallpaper to the Limine menu
• Migrates an installed XeroLinux system from GRUB to Limine, in a single guided wizard
• Enables Secure Boot via sbctl: creates, enrolls, and signs keys for Limine and your kernels
• Detects other installed operating systems and preserves dual-boot via Limine chainload entries
• Detects UEFI, GPT, and LUKS root (including LVM-on-LUKS), carrying over your GRUB kernel parameters
• Every step runs through a single root-privileged helper (xsb-helper) via pkexec, with visible live progress
• Refuses to remove GRUB until Limine is verified working, and refuses to migrate while Secure Boot is already on
• If Limine is already installed (a prior migration already completed), skips straight to Secure Boot setup instead of refusing - lets you finish or retry Secure Boot enrollment on its own

Requirements

• An installed XeroLinux system, booted in UEFI mode with a GPT partition table

Installation

Install from the XeroLinux repositories:

sudo pacman -S xsb-gui

Usage

Launch from your application launcher ("Limine/SecureBoot Enabler"). The wizard walks you through pre-flight checks, a summary of what will happen, the GRUB-to-Limine migration itself, and Secure Boot enrollment, in that order. If Limine is already installed, the migration step is skipped and the wizard goes straight to Secure Boot enrollment.

License

GPL-3.0-or-later. See LICENSE.