Gruvbox Plus by @SylEleuth · Any WM / DE on Any distro

01. Overview & Architecture

Profile: v6.6.0

Schema validatedSource pinned

Purpose: Icon pack built around the Gruvbox palette.
Compatibility: Any distro (Server: BOTH)
Desktop Part: Icon themes
Window Manager & Theme: Any WM / DE / Gruvbox

02. Installation & Deployment

Before you installThis changes your desktop configuration and installs packages. Run it as your normal user, never with sudo: it asks for sudo only where a step needs it (listed below).The guided installer shows its plan first. Files it would replace are kept unless you approve. Everything it copies, clones or appends to in your home folder is backed up and verified first, and --rollback restores it. Packages, sudo changes and the other commands listed under Impact are not undone.

Origingithub.com/SylEleuth/gruvbox-plus-icon-packPinned to 788efb291c0f · reviewed in this config file

IntegrityEach release from main builds the installers in GitHub Actions and signs them with a GitHub build attestation. Verify your download against the repository, not this website (Option B, step 2). If it does not verify, don't run it.

ImpactPackages: gruvbox-plus-icon-theme-git (some from the Arch AUR)

RecoveryGuided: backups in ~/.local/state/0xtsoa/backups/, undo with bash install.sh --rollback.Manual: the steps below only write in the download folder or run listed commands.

Option A: manual installAdvanced

Read the source at the reviewed commit, back up, then run each step yourself.

$git clone https://github.com/SylEleuth/gruvbox-plus-icon-pack ~/0xtsoa-review/syleleuth-gruvbox-plus-icon-pack# 1. clone to a review folder

$git -C ~/0xtsoa-review/syleleuth-gruvbox-plus-icon-pack checkout --detach 788efb291c0feb216c48d74d2da5bdf199cd5481# 2. the reviewed commit

Then the steps. Package commands are written for Arch; on other distros use your package manager.

Step-by-step deployment protocol

Step-by-step deployment

1Install gruvbox-plus-icon-theme-git (AUR)

Shell commands

$yay -S gruvbox-plus-icon-theme-git # AUR

$# Other distros: see the upstream README

Option B: guided installerRecommended

The same steps as one script for any distro. It shows the plan first, keeps files you already have unless you approve replacing them, and backs up everything it changes in your home folder. Never pipe it into a shell.

$curl -fsSLo install.sh 'https://www.0xtsoa.dev/configs/syleleuth/gruvbox-plus-icon-pack/install.sh'# 1. download

$

gh attestation verify install.sh --repo nyharena25/0xTsoa --signer-workflow nyharena25/0xTsoa/.github/workflows/attest-installers.yml

# 2. verify (GitHub CLI 2.49+, signed in)

$less install.sh# 3. read it

$bash install.sh --dry-run# 4. preview: changes nothing

$bash install.sh# 5. install (asks first)

$bash install.sh --rollback# undo the file changes

View script in browserOther options: --force (replace conflicts, backed up first), --yes, --help

04. Documentation & Guide

Source: SylEleuth/gruvbox-plus-icon-packRef: 788efb291c

README.md|GitHub Flavored Markdown

Raw Source ↗

Gruvbox Plus is the icon pack for Linux, based on and inspired by Suru++, OneDark, Gruvbox icon pack, GruvboxMateria, Papirus, and original Breeze Dark from KDE.

Gruvbox Plus is using color scheme from Gruvbox.

Previews

Apps:

preview-apps

Media types:

preview-miemetypes

Installation

Repositories

Arch Linux

You can install Gruvbox Plus from AUR repository (maintained by Diaoul).

Release version - https://aur.archlinux.org/packages/gruvbox-plus-icon-theme

yay -S gruvbox-plus-icon-theme

Git version - https://aur.archlinux.org/packages/gruvbox-plus-icon-theme-git

yay -S gruvbox-plus-icon-theme-git

NixOS

Git version (maintained by Eureka-cpu and Gliczy)

nix-env -iA nixos.gruvbox-plus-icons

OpenSUSE

Release version - https://build.opensuse.org/package/show/home:CouldBeMathijs/gruvbox-plus-icon-theme (maintained by MogelijksMathijs)

zypper addrepo https://download.opensuse.org/repositories/home:CouldBeMathijs/openSUSE_Tumbleweed/home:CouldBeMathijs.repo
zypper refresh
zypper install gruvbox-plus-icon-theme

Note

Icon pack lacks of linux repositories maintainers. If You want to become one please create a new issue or make a pull request.

Store

Icons are available on OpenDesktop store. You can manually download the archive from there or install it directly from Your system's icon manager settings. For example in KDE, open System Settings -> Colors & Themes -> Icons and click "Get New..." where You can search for Gruvbox Plus icons.

Manual installation

Go to the releases page and choose the zip file from the latest version.

Unpack the archive and copy the content to the .local/share/icons directory.

cp -rv Gruvbox-Plus-Dark Gruvbox-Plus-Light ~/.local/share/icons

If You want the latest icons, You would have to clone the whole repository:

git clone https://github.com/SylEleuth/gruvbox-plus-icon-pack.git

and copy or soft link folders:

ln -s path/to/repository/Gruvbox-Plus-Dark ~/.local/share/icons/Gruvbox-Plus-Dark

ln -s path/to/repository/Gruvbox-Plus-Light ~/.local/share/icons/Gruvbox-Plus-Light

You could then just use

git pull

to download files added since the latest pull.

Color variants

There are two available variants:

Gruvbox Dark - light symbolic icons for dark themes
Gruvbox Light - dark symbolic icons for light themes

If You are KDE Plasma user You can safely use Gruvbox Dark variant. Monochrome (symbolic) icons will change automatically depending on the color scheme.

Folder's color

There are 24 colors that You can choose from:

folders plasma

Plasma is a a special variant for KDE Plasma users. You can change color straight from System Settings: Colors & Themes -> Colors.

If You are using different Desktop Environment You can easily change the folder's color with special script (thanks to akarzim). Script is located in the scripts folder of the repository. You can download it from release page as a seperate file.

Script's usage

Change script's permission:

chmod +x folders-color-chooser.sh

then run it (it will work from any location, it doesn't have to be placed in icons directory):

./folders-color-chooser -c <color>

More details:

Usage:
  folders-color-chooser [-c | --color=<color>] [-C | --reset-color]
  folders-color-chooser [-h | --help]
  folders-color-chooser [-l | --list]

Options:
  -c, --color=<color>   set the new folders color
  -C, --reset-color     reset folder color to plasma
  -h, --help            show this help
  -l, --list            list available colors

If You don't want to use the script, there is a folder called folders where You will find all color sets grouped separately. Just replace places/scalable directory with any chosen color.

Contribution

If You'll find a missing icon please open a new issue and give as much information as You can:

If it's a program, please provide a name and a link to the repository page (or webpage if repo doesn't exist).
If You can, find a link to the original svg icon.
Link to .desktop file (located in .local/share/applications or usr/share/applications folder).

If You want to create new icons Yourself or modify existing ones please read THIS.

If You have any questions, suggestions or propositions please use Discussions page.

Support

If You downloaded the icon pack or if You just liked it please star the repository for visibility and as appreciation gesture.

License

Gruvbox Plus icon theme is a free and open source project distributed under the terms of the GNU General Public License, version 3. See the `LICENSE` file for details.

You can find additional licenses here.

GitHub Flavored Markdown (github-markdown-css)README snapshot at 788efb291c

Gruvbox Plus