gnome-shell/README.md: Drop support for Ubuntu sessions
Ubuntu sessions are no longer supported as already described in the root README.md, and Ubuntu 17.10 - 18.10 sessions-specific styles were removed from the newer SCSS code.
Ubuntu sessions are no longer supported as already described in the root README.md, and Ubuntu 17.10 - 18.10 sessions-specific styles were removed from the newer SCSS code.
by roundabout, Thursday, 27 February 2020, 16:53:27 (1582822407), pushed by roundabout, Sunday, 11 May 2025, 13:22:49 (1746969769)
Author identity: nana-4 <hnmaigo@gmail.com>
43c1cdeb4d4efc10ddf657183111314639f9aa48
## Installation
1. **Back up** the original theme file(s) first. If you are already using a custom GDM theme, skip this:
1. **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{,~}
# 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{,~}
```
2. Select a **GTK** theme to decide which variant to install.
3. Replace the default theme file(s):
3. Replace the default theme file:
```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
```
4. Reload the theme. If you are running GNOME Shell, press <kbd>Alt</kbd> + <kbd>F2</kbd> then type `rt`.
## Uninstallation
1. Restore to the original theme file(s) from the backup:
1. Restore to the original theme file 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{~,}
```
2. Reload the theme. If you are running GNOME Shell, press <kbd>Alt</kbd> + <kbd>F2</kbd> then type `rt`.