WhiteSur GTK Theme

A macOS like theme for Linux GTK Desktops

Donate

If you like my project, you can buy me a coffee, many thanks ❤️ !

Installation is easy!

Quick install

Installing from source

1. Run git clone https://github.com/vinceliuice/WhiteSur-gtk-theme.git --depth=1

2. Run ./install.sh to install the default WhiteSur GTK theme pack.

Uninstall

• uninstall Gtk themes: ./install.sh -r
• uninstall GDM theme: sudo ./tweaks.sh -g -r
• uninstall Firefox theme: ./tweaks.sh -f -r
• uninstall Flatpak Gtk themes: ./tweaks.sh -F -r

There's so many customizations you can do!

Usage: ./install.sh [OPTIONS...]

Fix for libadwaita (not perfect)

Run this command to install WhiteSur into gtk-4.0 configuration folder ($HOME/.config/gtk-4.0)

./install.sh -l                # Default is the normal dark theme
./install.sh -l -c light       # install light theme for libadwaita

Change theme color and accent

- Install theme accent

Parameter: --theme -t (repeatable)

Example:

./install.sh -t red            # install red theme accent only
./install.sh -t red -t green   # install red and green theme accents
./install.sh -t all            # install all available theme accents

Change Nautilus style

Parameter: --nautilus -N

Example: ./install.sh -N mojave

Explore more customization features!

You can run ./install.sh -h to explore more customization features we have like changing panel opacity, theme opacity (normal and solid variant), window control button variant, etc.

Let's tweak!

Usage: ./tweaks.sh [OPTIONS...]

There's more themes you can try!

Install and edit Firefox theme

- Install Firefox theme

Parameter: --firefox -f

Example: ./tweaks.sh -f

- Edit Firefox theme

Parameter: --edit-firefox -e

Example:

./tweaks.sh -e           # edit the installed Firefox theme
./tweaks.sh -f -r        # remove installed Firefox theme
./tweaks.sh -f monterey  # install Monterey Firefox theme

Install and customize GDM theme

- Install GDM theme

Parameter: --gdm -g (requires to be run as root)

Example: sudo ./tweaks.sh -g

- Change the background

Parameter: --background -b

Example:

sudo ./tweaks.sh -g -b "my picture.jpg" # use the custom background
sudo ./tweaks.sh -g -b default          # use the default background
sudo ./tweaks.sh -g -b blank            # make it blank

- Don't darken the background

Parameter: --nodarken -nd

Example:

sudo ./tweaks.sh -g -nd                          # darken the default background
sudo ./tweaks.sh -g -nd -b "wallpapers/snow.jpg" # darken the custom background

- Don't blur the background

Parameter: --noblur -nb

Example:

sudo ./tweaks.sh -g -nb                           # don't blur the default background
sudo ./tweaks.sh -g -nb -b "wallpapers/rocks.jpg" # don't blur the custom background

- Do more GDM customizations

You can do the similar customization features in ./install.sh like changing theme color (dark and light variant) and accent, GNOME Shell 'Activities' icon, etc. related to GDM. Run ./tweaks.sh -h to explore!

Fix for Flatpak

1. Run command to fix it

sudo flatpak override --filesystem=xdg-config/gtk-3.0 && sudo flatpak override --filesystem=xdg-config/gtk-4.0

If you use flatpak apps, you can run this to fix theme issue

2. Connect WhiteSur theme to Flatpak (gtk 3.0) (Snap not support)

Parameter: --flatpak -F

Example: ./tweaks.sh -F

Other recommended stuff

WhiteSur Icon Theme

WhiteSur Wallpapers

Technical details and getting involved

Please go read CONTRIBUTING.md for more info