**Gruvbox Plus** is the icon pack for Linux, based on and inspired by [Suru++](https://github.com/gusbemacbe/suru-plus), [OneDark](https://github.com/adhec/one-dark-icons), [Gruvbox icon pack](https://store.kde.org/p/1327720/), [GruvboxMateria](https://github.com/FilipeMCruz/dotfiles/tree/master/current/icons/.local/share/icons/MateriaGruvbox), [Papirus](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme), and original Breeze Dark from KDE. **Gruvbox Plus** is using color scheme from [Gruvbox](https://github.com/morhetz/gruvbox).
Contents -------- - [Previews](#previews) - [Installation](#installation) - [Repositories](#repositories) - [Arch Linux](#arch-linux) - [NixOS](#nixos) - [Store](#store) - [Manual Installation](#manual-installation) - [Color Variants](#color-variants) - [Folder's Color](#folders-color) - [Script's Usage](#scripts-usage) - [Contribution](#contribution) - [Support](#support) - [License](#license) Previews -------- #### Apps:  #### Media types:  Installation ------------ #### Repositories ##### Arch Linux You can install Gruvbox Plus from AUR repository (maintained by [Diaoul](https://github.com/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](https://github.com/eureka-cpu) and [Gliczy](https://github.com/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](https://github.com/CouldBeMathijs)) ``` 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](https://www.opendesktop.org/p/1961046/) 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](https://github.com/SylEleuth/gruvbox-plus-icon-pack/releases) 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:   **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](https://github.com/akarzim)). Script is located in the `scripts` folder of the repository. You can [download it](https://github.com/SylEleuth/gruvbox-plus-icon-pack/releases/download/v6.2.0/folders-color-chooser.sh) 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 ` More details: ``` Usage: folders-color-chooser [-c | --color=] [-C | --reset-color] folders-color-chooser [-h | --help] folders-color-chooser [-l | --list] Options: -c, --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: 1. If it's a program, please provide a name and a link to the repository page (or webpage if repo doesn't exist). 2. If You can, find a link to the original svg icon. 3. 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](https://github.com/SylEleuth/gruvbox-plus-icon-pack/wiki/How-to-create-icons). If You have any questions, suggestions or propositions please use [Discussions page](https://github.com/SylEleuth/gruvbox-plus-icon-pack/discussions). 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`](LICENSE) file for details. You can find additional licenses [here](https://github.com/SylEleuth/gruvbox-plus-icon-pack/blob/master/Licenses).