dotfiles/.themes/oomox-darker/gnome-shell/README.md

2.7 KiB

How to change the GDM theme

To change the GDM (lock/login screen) theme, you need to replace the system's default GNOME Shell theme.

⚠️ Cautions ⚠️

  • If the replacement fails, your desktop environment will not work properly. So please be careful if doing this.
  • When applying this, other third-party GNOME Shell themes would look broken until you restore to the original theme.
  • If GNOME Shell has been updated and restored to the original theme, you will need to install this again.

    Note: On Arch Linux, you can automatically reinstall the GDM theme by creating a hook file. For example, if you use oomox-darker-compact as your GDM theme, put this file in the /usr/share/libalpm/hooks/ directory.

Requirements

  • glib-compile-resources — The package name depends on the distro.
    • glib2 (Arch Linux)
    • glib2-devel (Fedora, openSUSE, etc.)
    • libglib2.0-dev (Debian, Ubuntu, etc.)
  • libxml2-utils — Ubuntu users only.

Installation

  1. Back up the original theme file(s) first. If you are already using a custom GDM theme, skip this:
sudo cp -av /usr/share/gnome-shell/gnome-shell-theme.gresource{,~}

# For Ubuntu 17.10 or 18.04, you also need the following:
sudo cp -av /usr/share/gnome-shell/theme/ubuntu.css{,~}

# For Ubuntu 18.10, you also need the following:
sudo cp -av /usr/share/gnome-shell/theme/Yaru/gnome-shell.css{,~}
  1. Select a GTK theme to decide which variant to install.
  2. Replace the default theme file(s):
GTK_THEME=$(gsettings get org.gnome.desktop.interface gtk-theme | sed "s/'//g")
cd /usr/share/themes/${GTK_THEME}/gnome-shell
sudo glib-compile-resources --target=/usr/share/gnome-shell/gnome-shell-theme.gresource gnome-shell-theme.gresource.xml

# For Ubuntu 17.10 or 18.04, you also need the following:
sudo cp -av gnome-shell.css /usr/share/gnome-shell/theme/ubuntu.css

# For Ubuntu 18.10, you also need the following:
sudo cp -av gnome-shell.css /usr/share/gnome-shell/theme/Yaru/gnome-shell.css
  1. Reload the theme. If you are running GNOME Shell, press Alt + F2 then type rt.

Uninstallation

  1. Restore to the original theme file(s) from the backup:
sudo mv -av /usr/share/gnome-shell/gnome-shell-theme.gresource{~,}

# For Ubuntu 17.10 or 18.04, you also need the following:
sudo mv -av /usr/share/gnome-shell/theme/ubuntu.css{~,}

# For Ubuntu 18.10, you also need the following:
sudo mv -av /usr/share/gnome-shell/theme/Yaru/gnome-shell.css{~,}
  1. Reload the theme. If you are running GNOME Shell, press Alt + F2 then type rt.