The Minecraft Grub Theme Trio:

> Minecraft Main Menu <	Minecraft World Selection Menu	Using both themes together

There is also a Spanish translation now!

Minegrub

A Grub Theme in the style of Minecraft!

Minegrub Preview "Screenshot"

Installation

Note: grub vs grub2

If you have a /boot/grub2 folder instead of a /boot/grub folder , you need to adjust the file paths mentioned here and in the minegrub-update.service file

Also if you're not sure, run grub-mkconfig -V to check if you have grub version 2 (you should have)

Manually

Clone this repository

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

(optional) Choose a background
```
./choose-background.sh  # or just copy a custom image to minegrub/background.png
```
- If you want to use the update script, copy an arbitrary number of images you would like to use to minegrub/backgrounds/. You can find some options in background_options/ but you can also use your own images.
- If you do not want to use the update script or if you always want to use the same background, you can use ./choose-background.sh or just copy a custom image to minegrub/background.png
Copy the folder to your boot partition: (for info: -ruv = recursive, update, verbose)
```
cd ./minegrub-theme
sudo cp -ruv ./minegrub /boot/grub/themes/
```
Open /etc/default/grub with your text editor and change/uncommon this line:
```
GRUB_THEME=/boot/grub/themes/minegrub/theme.txt
```

Update your live grub config by running

sudo grub-mkconfig -o /boot/grub/grub.cfg

You're good to go!

NixOS module (flake)

This is a minimal example

```nix # flake.nix { inputs.minegrub-theme.url = "github:Lxtharia/minegrub-theme"; # ... outputs = {nixpkgs, ...} @ inputs: { nixosConfigurations.HOSTNAME = nixpkgs.lib.nixosSystem { modules = [ ./configuration.nix inputs.minegrub-theme.nixosModules.default ]; }; } } # configuration.nix { pkgs, ... }: { boot.loader.grub = { minegrub-theme = { enable = true; splash = "100% Flakes!"; background = "background_options/1.8 - [Classic Minecraft].png"; boot-options-count = 4; }; # ... }; } ```

Configuration

Adjusting for a different amount of boot options:

When you have more/less than 4 boot options, you might want to adjust the height of the bottom bar (that says "Options" and "Console")
The formula and some precalculated values (for 2,3,4,5... boot options) are in the theme.txt, so you should be able to easily change it to the correct value.

Random splash texts and accurate "x Packages Installed" text!

The update_theme.py script chooses a random line from assets/splashes.txt and generates and replaces the logo.png which holds the splash text, as well as updates the amount of packages currently installed. It also randomly chooses a file from backgrounds/ (ignoring hidden files beginning with a dot) as the background image.

Make sure fastfetch or neofetch is installed
Make sure Python 3 (or an equivalent) and the Pillow python package are installed
- Install Pillow either with the python-pillow package from the AUR or with sudo -H pip3 install pillow
- It's important to use sudo -H, because it needs to be available for the root user
To add new splash texts simply edit ./minegrub/assets/splashes.txt and add them to the file.
Put all backgrounds you want to randomly choose from in ./minegrub/backgrounds/. Hidden files (i.e. filenames beginning with a dot) will be ignored. You can also add your own images.
If you want to get a specific splash and/or background for the next boot, run python update_theme.py [BACKGROUND_FILE [SPLASH]], e.g. python update_theme.py 'backgrounds/1.15 - [Buzzy Bees].png' 'Splashing!'
- Empty string parameters will be replaced by a random choice, e.g. python update_theme.py '' 'Splashing!' for a random background and the splash Splashing!.

Update splash and "Packages Installed"...

...manually

Just run python /boot/grub/themes/minegrub/update_theme.py (from anywhere) after boot using whatever method works for you

...with init-d (SysVinit)

Just copy the ./minegrub-SysVinit.sh under /etc/init.d as minecraft-grub then run update-rc.d minecraft-grub defaults as root privileges:

sudo cp -v "./minegrub-SysVinit.sh" "/etc/init.d/minecraft-grub"
sudo chmod u+x "/etc/init.d/minecraft-grub" # Just to be sure the permissions are set correctly.
sudo update-rc.d minecraft-grub defaults

...with systemd

Edit ./minegrub-update.service to use /boot/grub2/ on line 5 if applicable
Copy ./minegrub-update.service to /etc/systemd/system
Enable the service: systemctl enable minegrub-update.service
If it's not updating after rebooting (it won't update on the first reboot because it updates after you boot into your system), check systemctl status minegrub-update.service for any errors (for example if pillow isn't installed in the correct scope)

Notes:

the GRUB_TIMEOUT_STYLE in the defaults/grub file should be set to menu, so it immediately shows the menu (else you would need to press ESC and you dont want that)
I'm no Linux expert, that's why I explain it so thoroughly, for other newbies :>
i use arch btw
i hope u like it, cause i sure do lmao

Thanks to

https://github.com/toboot for giving me this wonderful idea!
the internet for giving me wisdom lmao (Mainly http://wiki.rosalab.ru/en/index.php/Grub2_theme_tutorial)
The contributors for contributing and giving me some motivation to improve some little things here and there
Vanilla Tweaks for some of the backgrounds

Font downloaded from https://www.fontspace.com/minecraft-font-f28180 and used for non commercial use.

Lxtharia / minegrub-theme

readme