INSTALL_GDM_THEME.md
Unicode text, UTF-8 text, with very long lines (342)
How to change the GDM theme
To change the GDM (lock/login screen) theme, you need to replace the system'sdefault GNOME Shell theme.
:warning: Cautions :warning:
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.
Tip: On Arch Linux, you can automatically reinstall the GDM theme by creating a hook file. For example, if you use Materia-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-bin
(Debian, Ubuntu, etc.)
libxml2-utils
— Ubuntu users only.
Installation
Back up the original theme file first. If you are already using a custom GDM theme, skip this:
sh
sudo cp -av /usr/share/gnome-shell/gnome-shell-theme.gresource{,~}
Select a GTK theme to decide which variant to install.
Replace the default theme file:
sh
THEME_NAME="$(gsettings get org.gnome.desktop.interface gtk-theme | sed "s/'//g")"
THEME_SRC_DIR="/usr/share/themes/$THEME_NAME/gnome-shell"
sudo glib-compile-resources --target="/usr/share/gnome-shell/gnome-shell-theme.gresource" --sourcedir="$THEME_SRC_DIR" "$THEME_SRC_DIR/gnome-shell-theme.gresource.xml"
Uninstallation
Restore to the original theme file from the backup:
sh
sudo mv -v /usr/share/gnome-shell/gnome-shell-theme.gresource{~,}
1# How to change the GDM theme 2 3To change the GDM (lock/login screen) theme, you need to replace the system's _default_ GNOME Shell theme. 4 5## :warning: Cautions :warning: 6 7- If the replacement fails, your desktop environment will not work properly. So please **be careful** if doing this. 8- When applying this, other third-party GNOME Shell themes would look broken until you restore to the original theme. 9- If GNOME Shell has been updated and restored to the original theme, you will need to install this again. 10> Tip: On Arch Linux, you can automatically reinstall the GDM theme by creating a [hook](https://wiki.archlinux.org/index.php/Pacman#Hooks) file. For example, if you use Materia-compact as your GDM theme, put [this file](https://gist.github.com/looselyrigorous/a1aa931ce48627cc39daccc9253b30c7) in the `/usr/share/libalpm/hooks/` directory. 11 12## Requirements 13 14- `glib-compile-resources` — The package name depends on the distro. 15- `glib2` (Arch Linux) 16- `glib2-devel` (Fedora, openSUSE, etc.) 17- `libglib2.0-dev-bin` (Debian, Ubuntu, etc.) 18- `libxml2-utils` — Ubuntu users only. 19 20## Installation 21 221. **Back up** the original theme file first. If you are already using a custom GDM theme, skip this: 23 24```sh 25sudo cp -av /usr/share/gnome-shell/gnome-shell-theme.gresource{,~} 26``` 27 282. Select a **GTK** theme to decide which variant to install. 293. Replace the default theme file: 30 31```sh 32THEME_NAME="$(gsettings get org.gnome.desktop.interface gtk-theme | sed "s/'//g")" 33THEME_SRC_DIR="/usr/share/themes/$THEME_NAME/gnome-shell" 34sudo glib-compile-resources --target="/usr/share/gnome-shell/gnome-shell-theme.gresource" --sourcedir="$THEME_SRC_DIR" "$THEME_SRC_DIR/gnome-shell-theme.gresource.xml" 35``` 36 374. Reload the theme. If you are running GNOME Shell, press <kbd>Alt</kbd> + <kbd>F2</kbd> then type `rt`. 38 39## Uninstallation 40 411. Restore to the original theme file from the backup: 42 43```sh 44sudo mv -v /usr/share/gnome-shell/gnome-shell-theme.gresource{~,} 45``` 46 472. Reload the theme. If you are running GNOME Shell, press <kbd>Alt</kbd> + <kbd>F2</kbd> then type `rt`. 48