Repolode
Submit
Lxtharia

Lxtharia/minegrub-theme

A GRUB bootloader theme that restyles the boot menu after Minecraft's main menu, with splash text and backgrounds.

View on GitHub
Stars
4,643
Forks
69
Open issues
7
Last commit
30 days ago

What is it?

Minegrub is a GRUB2 boot menu theme that recreates the look of the Minecraft main menu, including the title logo, blue-styled buttons, and a bottom bar with Options and Console entries. It is installed by copying a theme folder to the boot partition and pointing GRUB_THEME at its theme.txt file.

The theme includes an update_theme.py script that can pick a random splash line and background image on each boot, and update the displayed count of installed packages using fastfetch or neofetch. Background images placed in a backgrounds folder are chosen at random, and filenames with a version prefix automatically select a matching button style. A systemd service, a SysVinit script, and a NixOS flake module are provided for automating updates.

Key features

  • 01Recreates the Minecraft main menu layout and button styling in GRUB
  • 02Randomly selects splash text and background images on each boot
  • 03Shows the installed package count via fastfetch or neofetch
  • 04Matches button style automatically based on background version prefix
  • 05Includes an interactive install script, systemd service, and NixOS flake module

Use cases

  • Customizing the boot menu on a Linux machine that uses GRUB2
  • Giving a personal Linux desktop or shared lab machine a themed boot screen
  • Rotating boot-screen backgrounds and splash text automatically after each boot

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/Lxtharia/minegrub-theme.git
  2. 2

    Enter the project folder

    cd ./minegrub-theme
  3. 3

    Run the interactive installation script as root

    sudo ./install_theme.sh

Things to know

  • Secure Boot blocks the Minecraft font, so GRUB falls back to its default font.
  • Layout needs manual adjustment if you have a boot option count other than four.
  • Automatic splash and package updates require Python 3, the Pillow package, and fastfetch or neofetch.
  • The bundled Minecraft font is licensed for non-commercial use only.

Topics

#grub#grub-theme#linux#boot-menu#minecraft#theming#nixos#grub-themes#grub2#grub2-theme

FAQ

What is minegrub-theme?
A GRUB bootloader theme that restyles the boot menu after Minecraft's main menu, with splash text and backgrounds. Minegrub is a GRUB2 boot menu theme that recreates the look of the Minecraft main menu, including the title logo, blue-styled buttons, and a bottom bar with Options and Console entries. It is installed by copying a theme folder to the boot partition and pointing GRUB_THEME at its theme.txt file.
Is minegrub-theme free to use? What license does it have?
minegrub-theme is open source under the MIT license. Check the license terms before using it in commercial products.
Is minegrub-theme still maintained?
Actively maintained. The last commit to minegrub-theme was on Oct 8, 2026.
What can I use minegrub-theme for?
Customizing the boot menu on a Linux machine that uses GRUB2 Giving a personal Linux desktop or shared lab machine a themed boot screen Rotating boot-screen backgrounds and splash text automatically after each boot
How do I install minegrub-theme?
Clone the repository: git clone https://github.com/Lxtharia/minegrub-theme.git Enter the project folder: cd ./minegrub-theme Run the interactive installation script as root: sudo ./install_theme.sh
Where can I get minegrub-theme?
The source code and installation instructions are on GitHub: https://github.com/Lxtharia/minegrub-theme

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects