.. Public domain 2014 Luis Felipe López Acevedo <felipe.lopac@gmail.com>
 
    This work is dedicated to the public domain. To the extent possible under
    law, Luis Felipe López Acevedo has waived all copyright and related or
    neighboring rights to Aurora documentation.


GRUB 2
======

A background image for GNU GRUB 2 is available in :file:`aurora/grub` and
can be installed in :file:`/usr/share/images/desktop-base`, in the file
system.

.. figure:: /_static/aurora-wide-grub.png
   :alt: GNU GRUB 2 menu with Aurora background

GRUB settings need to be updated to change the value of the following
variables:

* ``background_image=/usr/share/images/desktop-base/aurora-wide-grub.png``
* ``color_highlight=yellow/black``
* ``menu_color_highlight=yellow/blue``

After making the changes and running :command:`update-grub`, the section
``### BEGIN /etc/grub.d/05_debian_theme ###`` in GRUB configuration file,
:file:`/boot/grub/grub.cfg`, should look like this:

.. sourcecode:: bash

    ### BEGIN /etc/grub.d/05_debian_theme ###
    insmod part_msdos
    insmod ext2
    set root='(hd0,msdos1)'
    search --no-floppy --fs-uuid --set=root f535ebcb-0808-4a36-8fa1-127938d1837d
    insmod png
    if background_image /usr/share/images/desktop-base/aurora-wide-grub.png; then
      set color_normal=white/black
      set color_highlight=yellow/black
    else
      set menu_color_normal=white/blue
      set menu_color_highlight=yellow/blue
    fi
    ### END /etc/grub.d/05_debian_theme ###