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!
Required dependencies (click to open)
"Install from source" deps
- sassc
- libglib2.0-dev-bin
ubuntu 20.04
- libglib2.0-dev
ubuntu 18.04 debian 10.03 linux mint 19
- libxml2-utils
ubuntu 18.04 debian 10.03 linux mint 19
- glib2-devel
Fedora Redhat
Misc deps
- imagemagick
(optional for GDM theme tweak)
- dialog
(optional for installation in dialog mode)
- optipng
(optional for asset rendering)
- inkscape
(optional for asset rendering)
Don't worry, WhiteSur installer already provides all of those dependencies.
Recommended GNOME Shell extensions (click to open)
- user-themes to enable gnome-shell theme (and not just the application theme)
- dash-to-dock
- blur-my-shell
Quick install
Installing from source
-
Run git clone https://github.com/vinceliuice/WhiteSur-gtk-theme.git --depth=1
-
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...]
Options (click to open)
OPTIONS:
-d, --dest DIR
Set destination directory. Default is '/home/[USER_NAME]/.themes'
-n, --name NAME
Set theme name. Default is 'WhiteSur'
-o, --opacity [normal|solid]
Set theme opacity variants. Repeatable. Default is all variants
-c, --color [light|dark]
Set theme color variants. Repeatable. Default is all variants
-a, --alt [normal|alt|all]
Set window control buttons variant. Repeatable. Default is 'normal'
-t, --theme [default|blue|purple|pink|red|orange|yellow|green|grey|all]
Set theme accent color. Repeatable. Default is BigSur-like theme
-s, --scheme [standard|nord]
Set theme colorscheme style. Repeatable. Default is 'standard'
-m, --monterey
Set to MacOS Monterey style.
-N, --nautilus [stable|normal|mojave|glassy|right]
Set Nautilus style. Default is BigSur-like style (stabled sidebar)
-l, --libadwaita
Install theme into gtk4.0 config for libadwaita. Default is dark version
-f, --fixed
Install fixed accent color version. Default is adaptive version
-HD, --highdefinition
Set to High Definition size. Default is laptop size
--shell, --gnomeshell
Tweaks for gnome-shell. Options:
1. -i, -icon [apple|simple|gnome|ubuntu|tux|arch|manjaro|fedora|debian|void|opensuse|popos|mxlinux|zorin|budgie|gentoo]
Set gnome-shell panel 'Activities' icon. Default is 'standard'
2. -b, -background [default|blank|IMAGE_PATH]
Set gnome-shell background image. Default is BigSur-like wallpaper
3. -p, -panelopacity [default|30|45|60|75]
Set gnome-shell panel transparency. Default is 15%
4. -h, -panelheight [default|smaller|bigger]
Set gnome-shell panel height size. Default is 32px
5. -sf, -smallerfont
Set gnome-shell font size to smaller (10pt). Default is 11pt
6. normal, -normal
Set gnome-shell show apps button style to normal. Default is BigSur
--round, --roundedmaxwindow
Set maximized window to rounded. Default is square
--black, --blackfont
Set panel font color to black. Default is white
--darker, --darkercolor
Install darker 'WhiteSur' dark themes.
--dialog, --interactive
Run this installer interactively, with dialogs.
--silent-mode
Meant for developers: ignore any confirm prompt and params become more strict.
-r, --remove, -u, --uninstall
Remove all installed WhiteSur themes.
-h, --help
Show this help.
Fix for libadwaita (not perfect)
Details (click to open)
Since the release of Gnome 43.0, more and more built-in apps use libadwaita now, and libadwaita does not support custom themes, which means we cannot change the appearance of app using libadwaita through gnome-tweaks or dconf-editor. For users who love custom themes, it’s really sucks!
Anyway if anybody who still want to custom themes we can only do this way:
that is to use the theme file to overwrite the gtk-4.0 configuration file. The result is that only Fixed making all gtk4 apps use one theme and cannot be switched (even can not switch to dark mode) If you want to change a theme, you can only re-overwrite the gtk-4.0 configuration file with a new theme, I know this method is not perfect, But at the moment it is only possible to continue using themes for libadwaita's apps ...
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...]
Options (click to open)
Usage: ./tweaks.sh [OPTION]
Tweaks for GDM theme. options
-g, --gdm Without options default GDM theme will install...
1. -b, -background [default|blank|IMAGE_PATH] Set GDM background image Default is BigSur-like wallpaper
2. -nd, -nodarken Don't darken 'WhiteSur' GDM theme background image
3. -nb, -noblur Don't blur 'WhiteSur' GDM theme background image
Tweaks for firefox. options
-f, --firefox [(monterey|flat)|alt|(darker|adaptive)] Without options default WhiteSur theme will install... Options:
1. monterey [3+3|3+4|3+5|4+3|4+4|4+5|5+3|5+4|5+5] Topbar buttons (not window control buttons) number: 'a+b' a: left side buttons number, b: right side buttons number
2. flat Monterey alt version Flat round tabs...
3. alt Alt windows button version Alt windows button style like gtk theme
4. darker Darker Firefox theme version Darker Firefox theme version
5. nord Nord Firefox colorscheme version Nord Firefox colorscheme version
6. adaptive Adaptive color version You need install adaptive-tab-bar-colour plugin first https://addons.mozilla.org/firefox/addon/adaptive-tab-bar-colour/
7. link Install links for theme Link source file to theme folder
-e, --edit-firefox [(monterey|flat)|alt|(darker|adaptive)]
Edit 'WhiteSur' theme for Firefox settings and also connect the theme to the current Firefox profiles.
Others. options
-F, --flatpak Support options: [-o, -c, -t...] Connect 'WhiteSur' theme to Flatpak Without options will only install default themes
1. -o, --opacity [normal|solid] Set 'WhiteSur' flatpak theme opacity variants Default is 'normal'
2. -c, --color [Light|Dark] Set 'WhiteSur' flatpak theme color variants Default is 'light'
3. -t, --theme [default|blue|purple|pink|red|orange|yellow|green|grey] Set 'WhiteSur' flatpak theme accent color Default is 'blue'
4. -s, --scheme [standard|nord] Set 'WhiteSur' flatpak theme colorscheme style Default is 'standard'
-d, --dash-to-dock
Fixed Dash to Dock theme issue.
-r, --remove, --revert
Revert to the original themes, do the opposite things of install and connect.
--silent-mode
Meant for developers: ignore any confirm prompt and params become more strict.
-h, --help
Show this help.
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
