WhiteSur-gtk-theme/README.md

WhiteSur GTK Theme

A macOS BigSur-like theme for your GTK apps

Installation is easy!

Required dependencies info for nerds

"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

• user-themes to enable gnome-shell theme (and not just the application theme)
• dash-to-dock gnome-shell <= 3.38
• dash-to-dock (GNOME Shell 40 patch) gnome-shell >= 40.0
• floating-dock (Dash to Dock alternative) gnome-shell <= 3.38
• blur-my-shell

Quick install

Installing from source

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

Uninstall

For example:

• 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

There's so many customizations you can do!

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

Options

-d, --dest DIR
Set destination directory. Default is '$HOME/.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)

-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.

Change theme color and accent

Install theme color

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

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-style -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

-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

-g, --gdm [default|x2]
Install 'WhiteSur' theme for GDM (scaling: 100%/200%, default is 100%). Requires to run this shell as root

-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.

-s, --snap
Connect 'WhiteSur' theme the currently installed snap apps.

-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: --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

Don't blur the 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

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!

Connect WhiteSur theme to Flatpak

Parameter: --flatpak -F

Example: ./tweaks.sh -F

Other recommended stuffs

WhiteSur Icon Theme

WhiteSur Wallpapers

Technical details and getting involved

Please go read CONTRIBUTING.md for more info