.. 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.


Desktop
=======

Aurora includes a visual theme for the GNOME 3 Desktop Environment.

.. figure:: /_static/gnewsense-4-gnome-desktop.png
   :alt: GNOME Desktop in gNewSense 4

The descktop theme, called *Aurora*, is located in
:file:`aurora/desktop/` and should be installed in :file:`/usr/share/themes/`.

End users of the system should be able to change the theme
from :menuselection:`Applications --> System Tools --> Advanced Settings`.
Background images can be changed from
:menuselection:`User --> System Settings --> Background`.


Icons
-----

Two icon themes are provided: gnewsense and gnewsense-light. The former is a
dark theme for light desktops; the latter is a light theme for dark desktops.

None of the icon themes provided is a completly new theme. They inherit almost
all icons from the default gnome icon theme, except the branding, which is
replaced for gNewSense's.

Icon themes are found in :file:`aurora/icons/` and can be installed in
:file:`/usr/share/icons/` in the file system.
    
Note that the desktop theme depends on these icon themes. This means both
icon themes must be installed for the desktop theme to work correctly.


GDM3 theme
----------

A GDM3 theme is available in :file:`aurora/gdm3` to overwrite Debian
defaults. It contains the following files:

* :file:`greeter.gsettings`: these are the options for the greeter session
  that can be set through :program:`GSettings`.
* :file:`gnewsense-shell-greeter.svg`: gNewSense logo image used by greeter
  when the user computer can render the new GNOME Shell.
* :file:`gnewsense-fallback-greeter.svg`: gNewSense logo image used by
  greeter when the user computer cannot render the new GNOME Shell.

To use the theme, the files above have to be placed in the following
locations:

.. sourcecode:: console

   # cp aurora/gdm3/greeter.gsettings /etc/gdm3/
   # cp aurora/gdm3/*.svg /usr/share/pixmaps/