README.md

September 9, 2025 · View on GitHub

Gruvbox GTK Theme

A GTK theme based on the colours of Sainnhe's great theme: Gruvbox Material for Neovim
the VinceLiuice's Awesome GTK Themes and the creativity of Gusbemacbe's: Suru Plus Icon Theme.

Gruvbox

Note

The theme is more focused on the Gnome Desktop, but supports Cinnamon, XFCE, Mate, etc. with generic styles. It's great to combine in your TWMs like: XmonadWM, AwesomeWM, BSPWM, etc...

⚙️ Requirements

Before installing the themes, make sure to install the following necessary packages: sassc murrine-engine and gnome-themes-extra packages for the correct rendering of themes.

Here are some commands to install on some distributions.

  • On Fedora run:
 sudo dnf install gtk-murrine-engine
  • On OpenSUSE run:
 sudo zypper install gtk2-engine-murrine
  • On Arch run:
sudo pacman -S gtk-engine-murrine
  • On Debian and derivatives run:
sudo apt install gtk2-engines-murrine

📁 Manual Installation

  • Download the themes packs and extract them
  • Move the extracted files to the following paths:
    • For GTK3: ~/.themes In this path you must move the entire theme folder.
    • For GTK4: ~/.config/gtk-4.0 The files to move to this path can be found inside the theme directory in the gtk-4.0 folder, copy only the assets, gtk.css and gtk-dark.css files or create a symlinks.

🔨 Applying the Theme

  • For GTK3, apply themes from Gnome Tweaks, Refine or Tuner
  • For GTK4 applications it is only necessary to have moved the assets, gtk.css and gtk-dark.css files to the ~/.config/gtk-4.0 path, and if you notice that the theme has not been applied, just close and reopen the application.

📦 Flatpak Compatibility

  • Override flatpak themes to ~/.themes:
sudo flatpak override --filesystem=$HOME/.themes
  • Override flatpak icons to ~/.icons:
sudo flatpak override --filesystem=$HOME/.icons
  • Override flatpak themes to ~/.config/gtk-4.0 locally:
flatpak override --user --filesystem=xdg-config/gtk-4.0
  • Override flatpak themes to ~/.config/gtk-4.0 globally:
sudo flatpak override --filesystem=xdg-config/gtk-4.0

Tip

💡 Use stylepak for easier Flatpak theming.

🛠 CLI Installation

Run the following command in the terminal for a general installation

./install.sh

The ./install.sh allows some specific options like:

./install.sh --tweaks medium macos outline float -t green -l

To customise the name of the theme, you can use the -n parameter, e.g.

./install.sh -n "Gruvbox-Float-Border" --tweaks outline float

Tip

🧾 For more information, run: ./install.sh --help

Options

-d, --dest DIR          Specify destination directory (Default: ~/.themes)

-n, --name NAME         Specify theme name (Default: Gruvbox)

-t, --theme VARIANT...  Specify theme accent color variant(s) [default|green|grey|orange|pink|purple|red|teal|yellow|all] (Default: blue)

-c, --color VARIANT...  Specify color variant(s) [light|dark] (Default: All variants)

-s, --size VARIANT...   Specify size variant [standard|compact] (Default: standard variant)

-l, --libadwaita        Link installed gtk-4.0 theme to config folder for all libadwaita app use this theme

-r, --remove,

-u, --uninstall         Uninstall/Remove installed themes or links

--tweaks                Specify versions for tweaks
                        1. [medium|soft]  Medium|Soft ColorSchemes version
                        2. black          Blackness color version
                        3. float          Floating gnome-shell panel style
                        4. outline        Windows with 2px outline style

-h, --help              Show help

🔠 Abbreviation Cheat Sheet

This is just to clarify doubts about the abbreviations of the Themes

Abbreviation exampleExplanation of abbreviations
Theme-Name-B-MBBordered Theme and window macOS Buttons
Theme-Name-B-LBBordered Theme and window Legacy Buttons
Theme-Name-B-GSFloating and Bordered Theme for Gnome Shell
Theme-Name-BL-MBBorderless Theme and window macOS Buttons
Theme-Name-BL-LBBorderless Theme and window Legacy Buttons
Theme-Name-BL-GSBorderless Theme decoration for Gnome Shell

🔗 More Neovim-Inspired GTK Themes

Neovim Colorschemes for GTKGitHubPling
Catppuccin GTK ThemeSourcePackage
Everforest GTK ThemeSourcePackage
Gruvbox GTK ThemeSourcePackage
Kanagawa GTK ThemeSourcePackage
Material GTK ThemeSourcePackage
Nightfox GTK ThemeSourcePackage
Osaka GTK ThemeSourcePackage
Rose Pine GTK ThemeSourcePackage
Tokyonight GTK ThemeSourcePackage

Acknowledgements to

Thanks to @telometto for the alternative to the application of themes in Flatpak.
Thanks to @f1yn for the solution to the active and inactive borders in the new version of Cinnamon.
Thanks to @eeeXun for the hint to solve the bug in Mate Desktop window control buttons.
Thanks to @Icy-Thought,@D3vil0p3r and to those who have packaged these themes for NIX and AUR.

Support

PayPal Support