A macOS BigSur-like theme for your GTK apps
Required dependencies (click to open)
- 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
- 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
Run ./install.sh
to install the default WhiteSur GTK theme pack.
For example: (click to open)
-
uninstall Gtk themes:
./install.sh -r
-
uninstall GDM theme:
sudo ./tweaks.sh -g -r
-
uninstall Firefox theme:
./tweaks.sh -f -r
-
uninstall Dash-to-dock theme:
./tweaks.sh -d -r
-
uninstall Flatpak Gtk themes:
./tweaks.sh -F -r
-
uninstall Snap Gtk themes:
./tweaks.sh -s -r
Usage: ./install.sh [OPTIONS...]
Options (click to open)
-d, --dest DIR
Set destination directory. Default is '/home/vince/.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
-p, --panel-opacity [default|30|45|60|75]
Set panel transparency. Default is 15%
-P, --panel-size [default|smaller|bigger]
Set Gnome shell panel height size. Default is 32px
-s, --size [default|180|220|240|260|280]
Set Nautilus sidebar minimum width. Default is 200px
-i, --icon [standard|simple|gnome|ubuntu|tux|arch|manjaro|fedora|debian|void|opensuse|popos|mxlinux|zorin]
Set 'Activities' icon. Default is 'standard'
-b, --background [default|blank|IMAGE_PATH]
Set gnome-shell background image. Default is BigSur-like wallpaper
-m, --monterey
Set to MacOS Monterey style.
-N, --nautilus-style [stable|normal|mojave|glassy]
Set Nautilus style. Default is BigSur-like style (stabled sidebar)
-l, --libadwaita
Install theme into gtk4.0 config for libadwaita. Default is dark version
-HD, --highdefinition
Set to High Definition size. Default is laptop size
--normal, --normalshowapps
Set gnome-shell show apps button style to normal. Default is bigsur
--round, --roundedmaxwindow
Set maximized window to rounded. Default is square
--right, --rightplacement
Set Nautilus titlebutton placement to right. Default is left
--black, --blackfont
Set panel font color to black. Default is white
--darker, --darkercolor
Install darker 'WhiteSur' dark themes.
--nord, --nordcolor
Install 'WhiteSur' Nord ColorScheme 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.
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
Parameter: --flatpak
-F
Example: ./tweaks.sh -F
Fix for Flatpak gtk-4.0 app:
sudo flatpak override --filesystem=xdg-config/gtk-4.0
Parameter: --color
-c
(repeatable)
Example:
./install.sh -c Light # install light theme color only
./install.sh -c Dark -c Light # install dark and light theme colors
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
Parameter: --nautilus-style
-N
Example: ./install.sh -N mojave
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.
Usage: ./tweaks.sh [OPTIONS...]
Options (click to open)
-g, --gdm [default|x2]
Install 'WhiteSur' theme for GDM (scaling: 100%/200%, default is 100%). Requires to run this shell as root
-o, --opacity [normal|solid]
Set 'WhiteSur' GDM theme opacity variants. Default is 'normal'
-c, --color [Light|Dark]
Set 'WhiteSur' GDM and Dash to Dock theme color variants. Default is 'light'
-t, --theme [default|blue|purple|pink|red|orange|yellow|green|grey]
Set 'WhiteSur' GDM theme accent color. Default is BigSur-like theme
-N, --no-darken
Don't darken 'WhiteSur' GDM theme background image.
-n, --no-blur
Don't blur 'WhiteSur' GDM theme background image.
-b, --background [default|blank|IMAGE_PATH]
Set 'WhiteSur' GDM theme background image. Default is BigSur-like wallpaper
-p, --panel-opacity [default|30|45|60|75]
Set 'WhiteSur' GDM (GNOME Shell) theme panel transparency. Default is 15%
-P, --panel-size [default|smaller|bigger]
Set 'WhiteSur' Gnome shell panel height size. Default is 32px
-i, --icon [standard|simple|gnome|ubuntu|tux|arch|manjaro|fedora|debian|void|opensuse|popos|mxlinux|zorin]
Set 'WhiteSur' GDM (GNOME Shell) 'Activities' icon. Default is 'standard'
--nord, --nordcolor
Install 'WhiteSur' Nord ColorScheme themes.
-f, --firefox [default|monterey|alt]
Install 'WhiteSur|Monterey|Alt' theme for Firefox and connect it to the current Firefox profiles. Default is WhiteSur
-e, --edit-firefox
Edit 'WhiteSur' theme for Firefox settings and also connect the theme to the current Firefox profiles.
-F, --flatpak
Connect 'WhiteSur' theme to Flatpak.
-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.
Parameter: --firefox
-f
Example: ./tweaks.sh -f
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
Parameter: --gdm
-g
(requires to be run as root)
Example: sudo ./tweaks.sh -g
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
Parameter: --no-darken
-N
Example:
sudo ./tweaks.sh -g -N # darken the default background
sudo ./tweaks.sh -g -N -b "wallpapers/snow.jpg" # darken the custom background
Parameter: --no-blur
-n
Example:
sudo ./tweaks.sh -g -n # don't blur the default background
sudo ./tweaks.sh -g -n -b "wallpapers/rocks.jpg" # don't blur the custom background
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!
Please go read CONTRIBUTING.md for more info