Installation via GRUB Customizer

In order to clone the repository from GitHub, you have to install Git, via the git package.
Alternatively, you can download a zip archive by clicking on Code then Download ZIP

Clone the repository

You can clone the repository or go to the release page and download a single theme.

git clone https://github.com/AdisonCavani/distro-grub-themes.git

Install GRUB Customizer

apt

sudo add-apt-repository ppa:danielrichter2007/grub-customizer
sudo apt-get update
sudo apt-get install grub-customizer

pacman

sudo pacman -S grub-customizer

dnf

sudo dnf install grub-customizer

eopkg

sudo eopkg install grub-customizer

Install a pre-made theme with GRUB Customizer

• Open GRUB Customizer
• Click on the Appearance settings tab
• Select Custom resolution and select or type in your resolution, e.g 1920x1080
• Press the Add theme button, then navigate to the directory where you cloned the repository; in my case /home/adison/distro-grub-themes
• Select your theme located in the /themes directory
• Save the changes

Install a custom-made theme with GRUB Customizer

• Extract and edit your theme located in the /themes folder
• With your file manager, inside the modified theme's directory, select all files and create an archive with .tar or .tar.xz format
• Open GRUB Customizer
• Click on the Appearance settings tab
• Enable Custom resolution and select or type in your resolution, e.g 1920x1080
• Press the Add theme button, then navigate to the directory where you cloned the repository; in my case /home/adison/distro-grub-themes
• Change the Archive files setting to All files
• Select your archive
• Save the changes

sudo rm /etc/default/grub.d/99_breeze-grub.cfg
sudo update-grub

Installation via Nix Flakes

Prerequisites

• Nix 2.4 or later
• Experimental features nix-command and flakes enabled.

  • You can achive that by setting the following options and rebuilding your system.

    configuration.nix

    nix = {
      package = pkgs.nixFlakes;
      extraOptions = ''
        experimental-features = nix-command flakes
      '';
    };
    

NixOS module

To use this theme as a NixOS module, a bare-minimum configuration would be as follows:

{
  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs?ref=nixos-unstable";
    distro-grub-themes.url = "github:AdisonCavani/distro-grub-themes";
  };
  outputs = { self, nixpkgs, ... }@inputs: {
    nixosConfigurations."default" = nixpkgs.lib.nixosSystem rec {
      system = "x86_64-linux";
      modules = [
        ./configuration.nix
        inputs.distro-grub-themes.nixosModules.${system}.default
      ];
    };
  };
}

{ config, pkgs, lib, ... }: {
  distro-grub-themes = {
    enable = true;
    theme = "<theme_name>";
  };
}

Standalone setup

To use this theme in a standalone setup, a bare-minimum configuration would be as follows:

{
  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs?ref=nixos-unstable";
    distro-grub-themes.url = "github:AdisonCavani/distro-grub-themes";
  };
  outputs = { self, nixpkgs, ... }@inputs: {
    nixosConfigurations."default" = nixpkgs.lib.nixosSystem rec {
      system = "x86_64-linux";

      specialArgs = {
        # Pass system and inputs to the configuration.nix file
        inherit system inputs;
      };

      modules = [
        ./configuration.nix
      ];
    };
  };
}

{ config, pkgs, lib, inputs, system, ... }: {
  
  boot.loader.grub = rec {
    theme = inputs.distro-grub-themes.packages.${system}.<theme_name>-grub-theme;
    splashImage = "${theme}/splash_image.jpg";
  };
}

Manual Installation

In order to clone the repository from GitHub, you have to install Git, via the git package.
Alternatively, you can download a zip archive by clicking on Code then Download ZIP.

Clone the repository

You can clone the repository, or go to the release page and download a single theme.

git clone https://github.com/AdisonCavani/distro-grub-themes.git

Create themes directory

To create themes directory, replace BOOT_GRUB_LOCATION with the directory where GRUB is located.
Usually it's /boot/grub or /boot/grub2 but some distributions have a different one, so you'll have to figure it out.

sudo mkdir BOOT_GRUB_LOCATION/themes

Edit or use a pre-made theme

cd distro-grub-themes/themes

Copy theme

The theme must be unpacked inside a folder before you can install it.

sudo tar -C BOOT_GRUB_LOCATION/themes/<theme_name> -xf <theme_name>.tar

Edit GRUB config

You can use your favourite text editor for this. Here, we use nano.

sudo nano /etc/default/grub

Uncomment this line and set your display resolution:

GRUB_GFXMODE=1920x1080

Make sure GRUB_TERMINAL_OUTPUT="console" is commented out!

At the end of the file, add the path of your theme:

GRUB_THEME="BOOT_GRUB_LOCATION/themes/<theme_name>/theme.txt"

Ctrl+O to save, Ctrl+X to exit.

Update Grub config

You'll need to tell GRUB to update its configuration in order to include the new theme.

Ubuntu and Debian-based systems:

sudo update-grub

Fedora, Arch & others:

If you have a UEFI system, run:

sudo grub-mkconfig -o BOOT_GRUB_LOCATION/grub.cfg

or

sudo grub2-mkconfig -o BOOT_GRUB_LOCATION/grub.cfg

sudo rm /etc/default/grub.d/99_breeze-grub.cfg
sudo update-grub

Install theme in Ventoy

Extract Ventoy.tar to /ventoy/theme

Locate ventoy.json file in /plugin/ventoy/ directory and change:

"file": "/ventoy/theme/blur/theme.txt",

to

"file": "/ventoy/theme/Ventoy/theme.txt",

For more information, head over to the Ventoy website.