Installation:

Usage: sudo ./install.sh [OPTIONS...]

  -t, --theme     Background theme variant(s) [forest|mojave|mountain|wave] (default is forest)
  -p, --type      Theme style variant(s)      [window|float|sharp] (default is window)
  -i, --side      Picture display side        [left|right] (default is left)
  -c, --color     Background color variant(s) [dark|light] (default is dark)
  -s, --screen    Screen display variant(s)   [1080p|2k|4k] (default is 1080p)
  -l, --logo      Show a logo on picture      [default|system] (default: a mountain logo)
  -r, --remove    Remove/Uninstall theme      (must add theme options, default is Elegant-forest-window-left-dark)
  -b, --boot      Install theme into '/boot/grub' or '/boot/grub2'
  -h, --help      Show this help

If no options are used, a user interface dialog will show up instead

Examples:

• Install mountain theme on 2k display device:

sudo ./install.sh -t mountain -s 2k

• Install wave theme into /boot/grub/themes:

sudo ./install.sh -b -t wave

• Uninstall mountain theme:

sudo ./install.sh -r -t mountain

Issues / tweaks:

Correcting display resolution:

• On the grub screen, press c to enter the command line
• Enter vbeinfo or videoinfo to check available resolutions
• Open /etc/default/grub, and edit GRUB_GFXMODE=[height]x[width]x32 to match your resolution
• Finally, run grub-mkconfig -o /boot/grub/grub.cfg to update your grub config

Setting a custom background:

• Make sure you have imagemagick installed, or at least something that provides convert
• Find the resolution of your display, and make sure your background matches the resolution
  • 1920x1080 >> 1080p
  • 2560x1440 >> 2k
  • 3840x2160 >> 4k
• Place your custom background inside the root of the project, and name it background.jpg
• Run the installer like normal, but with -s [YOUR_RESOLUTION] and -t [THEME] and -i [ICON]
  • Make sure to replace [YOUR_RESOLUTION] with your resolution and [THEME] with the theme

Contributing:

• If you made changes to icons, or added a new one:
  • Delete the existing icon, if there is one
  • Run cd assets; ./render-all.sh
• Create a pull request from your branch or fork
• If any issues occur, report then to the issue page

Preview:

Documents

Grub2 theme reference

Grub2 theme tutorial