<h1 align="center"> WhiteSur GTK Theme </h1> <p align="center"> <img src="docs/macbook.png"/> </p> <br> <p align="center"> <b> A macOS BigSur-like theme for your GTK apps </b> </p> <br> # Installation is easy! <details> <summary> Required dependencies info for nerds </summary> ### Gtk2 theme required - gtk-murrine-engine `Fedora/RedHat` - gtk2-engines-murrine `Ubuntu/Mint/Debian` - gtk-engine-murrine `Arch/Manjaro` ### Install from source required - 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` ### Theme tweaks required - imagemagick `(optional for Gdm theme tweaks)` - 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. </details> ## Quick install ### Use the stable package You can choose the compressed file [compiled in stable version](stable-release) and unzip it to the theme folder `~/.themes` under the user folder. ### Compile from source You can run `./install.sh` to install the default WhiteSur GTK theme pack which includes GNOME Shell (Pantheon), Cinnamon, XFWM (XFCE), Metacity, and Plank themes. ## There's so many customizations you can do! Usage: `./install.sh [OPTIONS...]` ### <p align="center"> <b> Change theme color and accent </b> </p> <p align="center"> <img src="docs/colors-themes.png"/> </p> #### Install theme color Parameter: `--color` `-c` (repeatable) Example: ```bash ./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: ```bash ./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 ``` ### <p align="center"> <b> Change Nautilus sidebar minimum width </b> </p> <p align="center"> <img src="docs/sidebars.png"/> </p> Parameter: `--sidebar` `-s` Example: `./install.sh -s 220` ### <p align="center"> <b> Change GNOME Shell 'Activities' icon </b> </p> <p align="center"> <img src="docs/icons.png"/> </p> Parameter: `--icon` `-i` Example: `./install.sh -i fedora` ### <p align="center"> <b> Change Nautilus style </b> </p> <p align="center"> <img src="docs/nautilus.png"/> </p> Parameter: `--nautilus-style` `-N` Example: `./install.sh -N mojave` ### <p align="center"> <b> Explore more customization features! </b> </p> 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! ### <p align="center"> <b> Install and edit Firefox theme </b> </p> <p align="center"> <img src="docs/firefox.png"/> </p> #### Install Firefox theme Parameter: `--firefox` `-f` Example: `./tweaks.sh -f` #### Edit Firefox theme Parameter: `--edit-firefox` `-e` Example: ```bash ./tweaks.sh -f -e # install and edit Firefox theme ./tweaks.sh -e -f # it's reversible! ./tweaks.sh -e # edit the installed Firefox theme ``` ### <p align="center"> <b> Install and customize Dash to Dock theme </b> </p> <p align="center"> <img src="docs/dash-to-dock.png"/> </p> #### Install Dash to Dock theme Parameter: `--dash-to-dock` `-d` Example: `./tweaks.sh -d` #### Change its color Parameter: `--color` `-c` Example: `./tweaks.sh -d -c dark` ### <p align="center"> <b> Install and customize GDM theme </b> </p> <p align="center"> <img src="docs/gdm.png"/> </p> #### Install GDM theme Parameter: `--gdm` `-g` (requires to be ran as root) Example: `sudo ./tweaks.sh -g` #### Change the background Parameter: `--background` `-b` Example: ```bash 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 ``` #### Make the background darker Parameter: `--darken` `-D` Example: ```bash sudo ./tweaks.sh -g -D # darken the default background sudo ./tweaks.sh -g -D -b "wallpapers/snow.jpg" # darken the custom background ``` #### Don't blur the background Parameter: `--no-blur` `-n` Example: ```bash 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`](#theres-so-many-customizations-you-can-do) like changing theme color (dark and light variant) and accent, GNOME Shell 'Activities' icon, etc. related to GDM. Run `./tweaks.sh -h` to explore! ## Using WhiteSur theme on app sandboxing platforms <p align="center"> <img src="docs/sandboxes.png"/> </p> ### <p align="center"> <b> Connect WhiteSur theme to Flatpak </b> </p> Parameter: `--flatpak` `-F` Example: `./tweaks.sh -F` ### <p align="center"> <b> Connect WhiteSur theme to your Snap apps </b> </p> Parameter: `--snap` `-S` Example: `./tweaks.sh -S` Note: > This can only connect WhiteSur theme to your currently installed Snap > apps. You may need to run this command again to connect to your newly installed > Snap apps # Other recommended stuffs ## Whitesur KDE Theme <p align="center"> <a href="https://github.com/vinceliuice/WhiteSur-kde"> <img src="docs/whitesur-kde-theme.png"/> </a> </p> <br> <p align="center"> <a href="https://github.com/vinceliuice/WhiteSur-kde"> <img src="docs/download-button.png"/> </a> </p> <br> ## Whitesur Icon Theme <p align="center"> <a href="https://github.com/vinceliuice/WhiteSur-icon-theme"> <img src="docs/whitesur-icon-theme.png"/> </a> </p> <br> <p align="center"> <a href="https://github.com/vinceliuice/WhiteSur-icon-theme"> <img src="docs/download-button.png"/> </a> </p> <br> ## Whitesur Wallpaper <p align="center"> <a href="https://github.com/vinceliuice/WhiteSur-kde/tree/master/wallpaper"> <img src="docs/whitesur-wallpaper.png"/> </a> </p> <br> <p align="center"> <a href="https://github.com/vinceliuice/WhiteSur-kde/tree/master/wallpaper"> <img src="docs/download-button.png"/> </a> </p> <br><br> # Technical details and getting involved Please go read [CONTRIBUTING.md](CONTRIBUTING.md) for more info