aiden
/
grub2-themes
mirror of https://github.com/vinceliuice/grub2-themes
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Modern Design theme for Grub2
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
246 Commits
1 Branch
13 Tags
46 MiB
Shell 81.2%
Nix 18.8%
 
 
master
1.2
2019-10-01
2019-10-28
2019_08_24
2020-06-23
2020-11-04
2021-01-26
2021-09-19
2021-12-05
2022-10-30
2024-08-19
2025-03-03
2025-07-23
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'b10a5fd4c8'
${ noResults }
Go to file
Vince b10a5fd4c8 update 3 years ago
assets update 3 years ago
backgrounds
…
common
…
config
…
LICENSE
…
README.md Added theme variant name to the preview image 3 years ago
banner.png
…
flake.nix Make splashImage option a `nullOr` type 4 years ago
install.sh Update install.sh to fix installation on Fedora 34 and later. 4 years ago
preview.png
…

README.md

banner

Installation:

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

Options: Description:
-b, --boot Install grub theme into /boot/grub/themes
-t, --theme theme variant(s) [tela/vimix/stylish/whitesur] (default is tela)"
-i, --icon icon variant(s) [color/white/whitesur] (default is color)"
-s, --screen screen resolution variant(s) [1080p/2k/4k/ultrawide/ultrawide2k] (default is 1080p)"
-r, --remove [THEME] Uninstall selected theme
-h, --help Show this help

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

Examples:

  • Install Tela theme on 2k display device:

    • sudo ./install.sh -t tela -s 2k

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

    • sudo ./install.sh -b -t tela

  • Uninstall Tela theme:

    • sudo ./install.sh -r -t tela

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, 2560x1080 -> --ultrawide, 2560x1440 -> --2k, 3440x1440 -> --ultrawide2k, 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:

Images shown: tela/vimix/stylish/whitesur preview

Documents

Grub2 theme reference

Grub2 theme tutorial