Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lxtharia/minegrub-world-sel-theme
A grub theme in the style of the Minecraft singleplayer (sp) world selection screen!
https://github.com/lxtharia/minegrub-world-sel-theme
grub-theme minecraft
Last synced: 5 days ago
JSON representation
A grub theme in the style of the Minecraft singleplayer (sp) world selection screen!
- Host: GitHub
- URL: https://github.com/lxtharia/minegrub-world-sel-theme
- Owner: Lxtharia
- License: mit
- Created: 2023-09-26T23:09:07.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-21T19:29:15.000Z (18 days ago)
- Last Synced: 2024-12-27T14:06:06.390Z (12 days ago)
- Topics: grub-theme, minecraft
- Language: Nix
- Homepage:
- Size: 19.1 MB
- Stars: 273
- Watchers: 5
- Forks: 11
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
**The Minecraft Grub Theme Trio:**
| [Minecraft Main Menu](https://github.com/Lxtharia/minegrub-theme) | *> Minecraft World Selection Menu <* | [Using both themes together](https://github.com/Lxtharia/double-minegrub-menu) |
| --- | --- | --- |
**Also check out these other projects:**
| [Minecraft SDDM Theme](https://github.com/Davi-S/sddm-theme-minesddm) by Davi-S | [Minecraft Plymouth Theme](https://github.com/nikp123/minecraft-plymouth-theme) by nikp123 |
| --- | --- |
# Minecraft World Selection Grub Theme
Wowie, another Minecraft grub theme! But this time it's in the style of the singleplayer world selection menu, which makes a little more sense than selecting your operating system from the main menu.
There are also *icons* now! Isn't that great? And even better, they also include the descriptive text below each boot option!
# Installation
- Clone this repository
```
git clone https://github.com/Lxtharia/minegrub-world-sel-theme.git
```
- [Optional]: download the background matching your screen size from [here](https://github.com/Lxtharia/minegrub-world-sel-theme/tree/c2b188a982a9ab1c092ee275e1ad1a643427d581/background-sizes)
- And copy it to `minegrub-world-selection/background.png`
- Copy the folder to your boot partition
```
cd ./minegrub-world-sel-theme
sudo cp -ruv ./minegrub-world-selection /boot/grub/themes/
```
- Change/add this line in your `/etc/default/grub`:
```
GRUB_THEME=/boot/grub/themes/minegrub-world-selection/theme.txt
```
- Update your live grub config by running
```
sudo grub-mkconfig -o /boot/grub/grub.cfg
```
### NixOS flake
Minimal example
```nix
# flake.nix
{
inputs.minegrub-world-sel-theme.url = "github:Lxtharia/minegrub-world-sel-theme";
# ...
outputs = {nixpkgs, ...} @ inputs: {
nixosConfigurations.HOSTNAME = nixpkgs.lib.nixosSystem {
modules = [
./configuration.nix
inputs.minegrub-world-sel-theme.nixosModules.default
];
};
}
}
# configuration.nix
{ pkgs, ... }: {
boot.loader.grub = {
minegrub-world-sel = {
enable = true;
customIcons = [{
name = "nixos";
lineTop = "NixOS (23/11/2023, 23:03)";
lineBottom = "Survival Mode, No Cheats, Version: 23.11";
# Icon: you can use an icon from the remote repo, or load from a local file
imgName = "nixos";
# customImg = builtins.path {
# path = ./nixos-logo.png;
# name = "nixos-img";
# };
}];
};
};
}
```
# Icons
GRUB can add icons to each entry, based on the `--class` properties of a `menuentry`.
This theme makes use of this to have each entry have its own icon _and_ world description!
**Example:**
```bash
# grub will try to use /boot/grub/themes/minegrub-world-selection/icons/arch.png as the icon and falls back on gnu-linux.png, gnu.png and os.png
menuentry 'Arch Linux' --class arch --class gnu-linux --class gnu --class os $menuentry_id_option 'gnulinux-simple-somefunnyuuid' {
...
}
```
## Setting icons for entries like Uefi Settings
> If you want items like Uefi Settings to have an icon, you need to add `--class uefi` manually to the menuentry line in `/boot/grub/grub.cfg`:
>
> `menuentry "Uefi Settings" --class uefi ...`
>
> In this case you can put it in `/etc/grub.d/30_uefi-firmware` so it doesn't get overwritten when you regenerate your grub.cfg :>
## [Generating/Contributing icons](icon-generator/README.md)
Click to read more ^
# Great
- I like writing Readme but at the same time, it takes too long and it's never perfect
- Everything feels like chaos
- I spent too much time on this
- Tell your grandparents and pets about this cool theme!
- Put it on your laptop, put it on your smartwatch put it on your schools PCs (i won't take responsibility if you get expelled)
- Install it on your mouse-with-screen, copy it to your flash drives
- Btw, have I mentioned that I use arch?
- I have a grand secret project that I may reveal soon
- Maybe it eats your food, maybe it doesn't
- Thank you internet for wisdom and funny youtube clips that kept me motivated on my journey
- **Go check out the other Minegrub: [Minegrub Theme](https://github.com/Lxtharia/minegrub-theme)**