README.md

                
                    
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
                
                    
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
                    
                
                    
11
                    ### Requirements
                
                    
12
                    
                
                    
13
                    - `glib-compile-resources` — The package name depends on the distro.
                
                    
14
                      - `glib2` (Arch Linux)
                
                    
15
                      - `glib2-devel` (Fedora, openSUSE, etc.)
                
                    
16
                      - `libglib2.0-dev` (Debian, Ubuntu, etc.)
                
                    
17
                    - `libxml2-utils` — Ubuntu users only.
                
                    
18
                    
                
                    
19
                    ### Installation
                
                    
20
                    
                
                    
21
                    1. **Back up** the original theme file(s) first. If you are already using a custom GDM theme, skip this:
                
                    
22
                    
                
                    
23
                      ```sh
                
                    
24
                      sudo cp -av /usr/share/gnome-shell/gnome-shell-theme.gresource{,~}
                
                    
25
                      # For Ubuntu 17.10 or 18.04, you also need the following:
                
                    
26
                      sudo cp -av /usr/share/gnome-shell/theme/ubuntu.css{,~}
                
                    
27
                      # For Ubuntu 18.10, you also need the following:
                
                    
28
                      sudo cp -av /usr/share/gnome-shell/theme/Yaru/gnome-shell.css{,~}
                
                    
29
                      ```
                
                    
30
                    
                
                    
31
                    2. Select a **GTK+** theme to decide which variant to install.
                
                    
32
                    3. Replace the default theme file(s):
                
                    
33
                    
                
                    
34
                      ```sh
                
                    
35
                      GTK_THEME=$(gsettings get org.gnome.desktop.interface gtk-theme | sed "s/'//g")
                
                    
36
                      cd /usr/share/themes/${GTK_THEME}/gnome-shell
                
                    
37
                      sudo glib-compile-resources --target=/usr/share/gnome-shell/gnome-shell-theme.gresource gnome-shell-theme.gresource.xml
                
                    
38
                      # For Ubuntu 17.10 or 18.04, you also need the following:
                
                    
39
                      sudo cp -av gnome-shell.css /usr/share/gnome-shell/theme/ubuntu.css
                
                    
40
                      # For Ubuntu 18.10, you also need the following:
                
                    
41
                      sudo cp -av gnome-shell.css /usr/share/gnome-shell/theme/Yaru/gnome-shell.css
                
                    
42
                      ```
                
                    
43
                    
                
                    
44
                    4. Reload the theme. If you are running GNOME Shell, press <kbd>Alt</kbd> + <kbd>F2</kbd> then type `rt`.
                
                    
45
                    
                
                    
46
                    ### Uninstallation
                
                    
47
                    
                
                    
48
                    1. Restore to the original theme file(s) from the backup:
                
                    
49
                    
                
                    
50
                      ```sh
                
                    
51
                      sudo mv -av /usr/share/gnome-shell/gnome-shell-theme.gresource{~,}
                
                    
52
                      # For Ubuntu 17.10 or 18.04, you also need the following:
                
                    
53
                      sudo mv -av /usr/share/gnome-shell/theme/ubuntu.css{~,}
                
                    
54
                      # For Ubuntu 18.10, you also need the following:
                
                    
55
                      sudo mv -av /usr/share/gnome-shell/theme/Yaru/gnome-shell.css{~,}
                
                    
56
                      ```
                
                    
57
                    
                
                    
58
                    2. Reload the theme. If you are running GNOME Shell, press <kbd>Alt</kbd> + <kbd>F2</kbd> then type `rt`.
                
                    
59