A fork of the Materia GTK theme.

Important information: Google announced that, from September 2026, Android devices will require ALL apps to be signed by Google, effectively leading to an iOS situation. Value your right to a computer that does what you want; do not tolerate this monopolistic practice! Contact me if you don't understand why it is bad. Click to learn more.

 README.md

View raw Download
text/plain • 2.73 kiB
Unicode text, UTF-8 text, with very long lines (343)

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.

    Note: 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

  1. Back up the original theme file(s) first. If you are already using a custom GDM theme, skip this:

`sh 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):

`sh 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:

`sh sudo mv -v /usr/share/gnome-shell/gnome-shell-theme.gresource{~,}

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

# For Ubuntu 18.10, you also need the following: sudo mv -v /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.

                
                    
1
# How to change the GDM theme
2
3
To 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
> Note: 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
22
1. **Back up** the original theme file(s) first. If you are already using a custom GDM theme, skip this:
23
24
```sh
25
sudo cp -av /usr/share/gnome-shell/gnome-shell-theme.gresource{,~}
26
27
# For Ubuntu 17.10 or 18.04, you also need the following:
28
sudo cp -av /usr/share/gnome-shell/theme/ubuntu.css{,~}
29
30
# For Ubuntu 18.10, you also need the following:
31
sudo cp -av /usr/share/gnome-shell/theme/Yaru/gnome-shell.css{,~}
32
```
33
34
2. Select a **GTK** theme to decide which variant to install.
35
3. Replace the default theme file(s):
36
37
```sh
38
GTK_THEME=$(gsettings get org.gnome.desktop.interface gtk-theme | sed "s/'//g")
39
cd /usr/share/themes/${GTK_THEME}/gnome-shell
40
sudo glib-compile-resources --target=/usr/share/gnome-shell/gnome-shell-theme.gresource gnome-shell-theme.gresource.xml
41
42
# For Ubuntu 17.10 or 18.04, you also need the following:
43
sudo cp -av gnome-shell.css /usr/share/gnome-shell/theme/ubuntu.css
44
45
# For Ubuntu 18.10, you also need the following:
46
sudo cp -av gnome-shell.css /usr/share/gnome-shell/theme/Yaru/gnome-shell.css
47
```
48
49
4. Reload the theme. If you are running GNOME Shell, press <kbd>Alt</kbd> + <kbd>F2</kbd> then type `rt`.
50
51
## Uninstallation
52
53
1. Restore to the original theme file(s) from the backup:
54
55
```sh
56
sudo mv -v /usr/share/gnome-shell/gnome-shell-theme.gresource{~,}
57
58
# For Ubuntu 17.10 or 18.04, you also need the following:
59
sudo mv -v /usr/share/gnome-shell/theme/ubuntu.css{~,}
60
61
# For Ubuntu 18.10, you also need the following:
62
sudo mv -v /usr/share/gnome-shell/theme/Yaru/gnome-shell.css{~,}
63
```
64
65
2. Reload the theme. If you are running GNOME Shell, press <kbd>Alt</kbd> + <kbd>F2</kbd> then type `rt`.
66