1# zuki-themes 2Themes for GNOME and XFCE4. 3 4#### Zukitre 5![Zukitre](zukitre.png?raw=true) 6<sub>[Wallpapers](https://imgur.com/a/zrijHvk) | [Icons](https://github.com/vinceliuice/Tela-icon-theme) | Fonts: Roboto / SF Mono | GNOME shell extension: Dash to Panel</sub> 7 8#### Zukitwo 9![Zukitwo](zukitwo.png?raw=true) 10<sub>[Wallpapers](https://imgur.com/a/zrijHvk) | [Icons](https://github.com/vinceliuice/Tela-icon-theme) | Fonts: Roboto / SF Mono | GNOME shell extension: Dash to Panel</sub> 11 12### Requirements 13 14- GNOME Shell 40.1+ (Older versions can be found under the releases section.) 15- GTK 3.24.13+ and/or GTK 4.2+ 16 17<sub>I can't guarantee that the themes will look as intended on older versions.</sub> 18 19Some of these packages may already be installed by default on some distros. (You can skip the gtk2 dependencies if you do not use any gtk2 applications. Then all you need to install is `git`, `meson`, `sassc`, and `ninja`) 20 21* Debian/Ubuntu/Mint/PopOS - `apt install gtk2-engines-murrine gtk2-engines-pixbuf ninja-build git meson sassc` 22* Arch/Manjaro - `pacman -S gtk-engines gtk-engine-murrine ninja git meson sassc` 23* Opensuse - `zypper in gtk2-engine-murrine gtk2-engines ninja git meson sassc` 24* Fedora - `dnf install gtk-murrine-engine gtk2-engines ninja-build git meson sassc` 25 26Other distros may have named the above packages differently. 27 28## Installation 29 30When the above requirements are installed, simply run these commands: 31```bash 32git clone https://github.com/lassekongo83/zuki-themes.git 33cd zuki-themes 34meson build 35sudo ninja -C build install 36``` 37The themes will be installed in: `/usr/share/themes/` 38 39### Updating the theme 40 41Navigate to the `zuki-themes` folder that was originally cloned. (If you removed it, do the steps above instead). 42 43Then simply run: 44```bash 45git pull 46sudo ninja -C build install 47``` 48 49### Local installation 50 51Install the theme(s) locally if you for some reason can't run as a sudo user. 52 53```bash 54git clone https://github.com/lassekongo83/zuki-themes.git 55cd zuki-themes 56meson build 57DESTDIR=/home/your-username/.themes ninja -C build install 58mv ~/.themes/usr/share/themes/* ~/.themes 59rm -r ~/.themes/usr 60``` 61 62#### Changing themes 63 64Use `gnome-tweaks` to change themes. 65 66You can also change your GTK themes using a terminal. 67```bash 68# Changing the theme to Zukitre-dark, simply run 69gsettings set org.gnome.desktop.interface gtk-theme Zukitre-dark 70 71# Reverting the change to the default GNOME theme 72gsettings set org.gnome.desktop.interface gtk-theme Adwaita 73``` 74 75To change the gnome-shell theme you need to install and activate the `User themes` extension in the [extensions app](https://flathub.org/apps/details/org.gnome.Extensions). 761. If the user-themes extension is not installed, then look for the package `gnome-shell-extensions` or `gnome-shell-extension-user-theme` and install it. (Or install it from https://extensions.gnome.org/extension/19/user-themes/) 772. Open the extensions app and activate the `user themes` extension. 783. Go to the Appearance page in `gnome-tweaks` and change the Shell theme to Zuki-shell in the drop-down list. (If it still shows a yellow triangle, then restart `gnome-tweaks` or relog.) 79 80Xfce users can change themes in `Settings > Appearance` and `Settings > Window manager` 81 82#### Flatpak applications 83 84To use the theme in Flatpak applications you'll have to copy the theme(s) from /usr/share/themes to ~/.themes (Symbolic links won't work.) 85 86The theme will be used if the included GTK version for the Flatpak app is at 3.24.x or 4.x. Some apps may require you to change the theme in the app's settings. 87 88#### Removing the themes 89 90To be safe from any gnome-shell crashes or weird behavior, change the gnome-shell theme to another one before removing the theme. 91 92As root, remove the `Zukitre Zukitwo Zukitre-dark Zukitwo-dark Zuki-shell` folders located in `/usr/share/themes/` 93 94## Copying or Reusing 95 96The GTK theme(s) and included scripts are free software licensed under the terms of the [GNU General Public License, version 3](https://www.gnu.org/licenses/gpl-3.0.txt). 97