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