Global

These themes governs the global items and properties for the GRUB menu. They are known as global. There are 3 ways to assign values for these properties:

  • name1: noSpaceValue - normal value
  • name2: "value with space" - string value
  • name3: #0351FF - color hex value

We'll review each properties in details.

Title

These are related to the title of the grub menu.

title-text

Specify the title string message.

title-font

Specify the font used for the title string.

title-color

Specify the color of for the title string.

Background

These fields are meant for setting the background of the screen.

desktop-color

Specifies the base background color.

desktop-image

Specifies the image to use as the background. The image should be stored inside the /boot/grub2/themes/<your_themes> directory.

desktop-image-scale-method

Specifies the scaling method for the background image. Options are:

  1. stretch - for fitting the screen size
  2. crop - proportionally scaled to fit the screen size
  3. padding - repeatedly contained on the screen
  4. fitwidth - fitting based on the screen width
  5. fitheight - fitting based on the screen height

Default is stretch.

desktop-image-h-align

Specifies the horizontal alignment of the background image if desktop-image-scale-method value is not stretch. Options are:

  1. left
  2. center
  3. right

Default is center.

desktop-image-v-align

Specifies the vertical alignment of the background image if desktop-image-scale-method value is not stretch. Options are:

  1. top
  2. center
  3. bottom

Default is center.

Terminal Layout

terminal-box

Specifies the file name pattern for the styled box slices used for the command line terminal window. For example:

  1. terminal-box: terminal_*.png will use:
    1. terminal_c.png as the center area
    2. terminal_n.png as the north (top) edge
    3. terminal_nw.png as the northwest (upper left) corner, and so on

If the image for any slice is not found, it will simply be left empty.

terminal-border

Specifies the border width of the terminal window.

terminal-left

Specifies the left coordinate of the terminal window.

terminal-top

Specifies the top coordinate of the terminal window.

terminal-width

Specifies the width of the terminal window.

terminal-height

Specifies the height of the terminal window.

terminal-font

Specifies the font for the terminal window.

Message Fields

These are reserved fields for backward compatibility. Currently they are unused, although you can set them.

message-font

message-color

message-bg-color