# suru-plus

**Repository Path**: laohuang02/suru-plus

## Basic Information

- **Project Name**: suru-plus
- **Description**: Suru++ 25 — A cyberpunk, elegant, futuristic and Papirus-like third-party icons theme
- **Primary Language**: Shell
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2019-04-20
- **Last Updated**: 2021-11-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
    <img src="images/logo-new.png" alt="Logotype" height="250px">
</p>

<h3 align="center">A third-party Suru icons for more than 20 distributions </h3>
<h3 align="center">Successor of <a href="https://github.com/Bonandry">@Bonandry</a>’s <a href="https://github.com/Bonandry/SURU-PLUS">Suru++ Ubuntu</a></h3>
<h3 align="center">A cyberpunkish, elegant, futuristic, macOS-like, papirusified and modern Suru icons based on <a href="https://snwh.org/suru">Suru Icons</a> by Sam Hewitt</h3>

<p align="center">
  <img alt="apps" src="https://img.shields.io/badge/apps_icons-5200%2B-1AD6AB.svg?style=plastic?&colorA=329DB6"/>
  <img alt="actions" src="https://img.shields.io/badge/actions_icons-1800%2B-1AD6AB.svg?style=plastic?&colorA=329DB6"/>
  <img alt="devices" src="https://img.shields.io/badge/devices_icons-150%2B-1AD6AB.svg?style=plastic?&colorA=329DB6"/>
  <img alt="mimetypes" src="https://img.shields.io/badge/mimetypes_icons-1100%2B-1AD6AB.svg?style=plastic?&colorA=329DB6"/>
  <img alt="panel" src="https://img.shields.io/badge/panel_icons-1900%2B-1AD6AB.svg?style=plastic?&colorA=329DB6"/>
  <img alt="places" src="https://img.shields.io/badge/places_icons-1500%2B-1AD6AB.svg?style=plastic?&colorA=329DB6"/>
</p>

<h1>Index</h1>

- [What’s new?](#whats-new)
  - [Version 20.0.0](#version-2000)
    - [Redesign](#redesign)
    - [Folder redesign and 12 folder colours](#folder-redesign-and-12-folder-colours)
    - [Mimetype icons redesign](#mimetype-icons-redesign)
    - [Firefox alternatives](#firefox-alternatives)
    - [New flags icons](#new-flags-icons)
  - [Version 25.0.0](#version-2500)
    - [Folders with colour of Linux Mint](#folders-with-colour-of-linux-mint)
    - [Distinction of file managers](#distinction-of-file-managers)
    - [Steam games](#steam-games)
  - [Version 25.1.0](#version-2510)
    - [Oomox](#oomox)
    - [Alternative icons](#alternative-icons)
  - [Version 25.2.0](#version-2520)
    - [Gradient support for small icons](#gradient-support-for-small-icons)
    - [New three folders colours – Indigo, pink and Manjaro-coloured](#new-three-folders-colours-%E2%80%93-indigo-pink-and-manjaro-coloured)
- [Installing with CLI](#installing-with-cli)
    - [ROOT directory (recommended)](#root-directory-recommended)
    - [HOME directory for GTK](#home-directory-for-gtk)
    - [HOME directory for KDE](#home-directory-for-kde)
    - [\*BSD systems](#bsd-systems)
    - [Uninstall](#uninstall)
- [Changing the folder colour](#changing-the-folder-colour)
- [Changing the alternative icon](#changing-the-alternative-icon)
  - [Firefox](#firefox)
  - [Alternative icons](#alternative-icons-1)
  - [File manager icon](#file-manager-icon)
- [Known bugs](#known-bugs)
  - [Snap-built apps](#snap-built-apps)
  - [AppImage-built apps](#appimage-built-apps)
  - [Hardcoded application icons with ugly name](#hardcoded-application-icons-with-ugly-name)
  - [Unattractive icons of Bluetooth Manager, Gigolo, Network Wifi, etc.](#unattractive-icons-of-bluetooth-manager-gigolo-network-wifi-etc)
  - [Hardcoded tray icons](#hardcoded-tray-icons)
  - [Unrecognised and ugly icons](#unrecognised-and-ugly-icons)
    - [Okular icon and other icons](#okular-icon-and-other-icons)
- [Report](#report)
- [Contribution](#contribution)
- [Contributors](#contributors)
- [Changelog](#changelog)
- [Credits and Licences](#credits-and-licences)

## What’s new?

### Version 20.0.0

#### Redesign

Following Sam Hewitt’s rules of grids, and making less conservative and traditional <a href="https://github.com/Bonandry">@Bonandry</a>’s <a href="https://github.com/Bonandry/SURU-PLUS">Suru++ Ubuntu</a>, more than 15k icons have been redesigned, papirusified and improved with new cyberpunk colours and made been compatible with KDE, XFCE and other many environments! Check the new icons:

![Screenshot](images/preview1-new.png)

#### Folder redesign and 12 folder colours

The new versions has won new colours of folders, based by Alexey Varfolomeev’s Papirus:

![Screenshot](images/preview2.png)

#### Mimetype icons redesign

Almost all mimetype icons have been redesigned with new colours and are based on Numix mimetype icons:

![Screenshot](images/preview3.png)

#### Firefox alternatives

You can choose one of three alternatives of Firefox:

| ![](images/firefox-traditional.png) | ![](images/firefox.png) | ![](images/firefox-mozilla.png) |
| :---------------------------------: | :---------------------: | :-----------------------------: |
|             Traditional             |        Suru++ 20        |       Mozilla Unofficial        |
|      `firefox-traditional.svg`      |      `firefox.svg`      |      `firefox-mozilla.svg`      |

To change the alternative icon, click to see [Changing the alternative icon](#changing-the-alternative-icon). 

#### New flags icons

New countries flags (in development)!

### Version 25.0.0

#### Folders with colour of Linux Mint

Suru++ won the new folders with colour of Linux Mint:

![Screenshot](images/preview4.png)

#### Distinction of file managers

The file managers are no longer same, now are different and modern:

<p align="center">
    <img src="images/preview5.png" alt="Screenshot" height="100px">
</p>

To change the default icon of each file manager (Caja, Nautilus, Nemo, etc.), see [File manager icon](#file-manager-icon).

#### Steam games

Hundreds Steam games icons are supported officially:

<p align="center">
    <img src="images/preview6.png" alt="Screenshot" height="450px">
</p>

### Version 25.1.0

#### Oomox

Suru++ is officially compatible with with @actionless's [Oomox](https://github.com/themix-project/oomox). You can change any colour of all 16px icons and of all folders once in a while!

#### Alternative icons

Redesigned by [@darcn181](https://github.com/darcn181). You can choose one of your alternates. To change the alternate, please see [Alternative icons](#alternative-icons).

|        Icon name         |                      Default                      |                        Alt 1                         |                        Alt 2                         |              Alt 3               |              Alt 4               |
| :----------------------: | :-----------------------------------------------: | :--------------------------------------------------: | :--------------------------------------------------: | :------------------------------: | :------------------------------: |
|         settings         |         ![default](./images/settings.png)         |         ![alt 1](./images/settings-alt1.png)         |         ![alt 2](./images/settings-alt2.png)         |                -                 |                -                 |
|       sublime-text       |       ![default](./images/sublime-text.png)       |       ![alt 1](./images/sublime-text-alt.png)        |                          -                           |                -                 |                -                 |
|    system-lock-screen    |    ![default](./images/system-lock-screen.png)    |    ![alt 1](./images/system-lock-screen-alt1.png)    |    ![alt 2](./images/system-lock-screen-alt2.png)    |                -                 |                -                 |
|      system-log-out      |      ![default](./images/system-log-out.png)      |      ![alt 1](./images/system-log-out-alt1.png)      |      ![alt 2](./images/system-log-out-alt2.png)      |                -                 |                -                 |
|      system-reboot       |      ![default](./images/system-reboot.png)       |      ![alt 1](./images/system-reboot-alt1.png)       |      ![alt 2](./images/system-reboot-alt2.png)       |                -                 |                -                 |
|     system-shutdown      |     ![default](./images/system-shutdown.png)      |     ![alt 1](./images/system-shutdown-alt1.png)      |     ![alt 2](./images/system-shutdown-alt2.png)      |                -                 |                -                 |
|      system-suspend      |      ![default](./images/system-suspend.png)      |      ![alt 1](./images/system-suspend-alt1.png)      |      ![alt 2](./images/system-suspend-alt2.png)      |                -                 |                -                 |
| system-suspend-hibernate | ![default](./images/system-suspend-hibernate.png) | ![alt 1](./images/system-suspend-hibernate-alt1.png) | ![alt 2](./images/system-suspend-hibernate-alt2.png) |                -                 |                -                 |
|           user           |           ![default](./images/user.png)           |           ![alt 1](./images/user-alt1.png)           |           ![alt 2](./images/user-alt2.png)           | ![alt 3](./images/user-alt3.png) | ![alt 4](./images/user-alt4.png) |

### Version 25.2.0

#### Gradient support for small icons

I added gradient support for all 16px icons of folders apps, categories, devices, mimetypes and places and made it compatible with Oomox and you can change two  gradient colours with any colours you want! I have inaugurated [Suru++ Colourise](https://github.com/gusbemacbe/suru-plus-colourise) with the help and contribution of [@actionless](https://github.com/actionless) and [@SmartFinn](https://github.com/SmartFinn), allowing you to choose and change one of 9 interesting and cyberpunk gradient colours!

![gradient colours](images/preview7.png)

#### New three folders colours – Indigo, pink and Manjaro-coloured

Suru++ won more new three colours for folders:

![three-folders-colours](images/preview8.png)

## Installing with CLI

Use the scripts to install the latest version directly from this repository (independently of your distribution):

**NOTE:** Use the same command to update the icon theme.

#### ROOT directory (recommended)

```
wget -qO- https://raw.githubusercontent.com/gusbemacbe/suru-plus/master/install.sh | sh
```

#### HOME directory for GTK

```
wget -qO- https://raw.githubusercontent.com/gusbemacbe/suru-plus/master/install.sh | env DESTDIR="$HOME/.icons" sh
```

#### HOME directory for KDE

```
wget -qO- https://raw.githubusercontent.com/gusbemacbe/suru-plus/master/install.sh | env DESTDIR="$HOME/.local/share/icons" sh
```

#### \*BSD systems

```
wget -qO- https://raw.githubusercontent.com/gusbemacbe/suru-plus/master/install.sh | env DESTDIR="/usr/local/share/icons" sh
```

#### Uninstall

```
wget -qO- https://raw.githubusercontent.com/gusbemacbe/suru-plus/master/install.sh | env uninstall=true sh
```

## Changing the folder colour

Please visit directly the tutorial: [Suru++ Folders](https://github.com/gusbemacbe/suru-plus-folders). The tutorial is translated in 7 languages.

## Changing the alternative icon

### Firefox

1. Go to `/usr/share/applications/`;
2. Go to the desktop file `Firefox`;
3. Open the file with your favourite text editor;
4. Find `Icon=...` and modify it with one of three alternatives: `Icon=firefox` or `Icon=firefox-mozilla` or `Icon=firefox-traditional`. Save it.

### Alternative icons

1. Run `cd "go_to_/Suru++/64/"`;
2. Download the script [`alt-icon.sh`](./scripts/alt-icon.sh), make it executable and trusted and copy the path of this script to the terminal;
3. For example:

```bash
cd ~/.local/share/icons/Suru++/64
$ ~/.local/share/icons/Suru++/64
~/alt-icon.sh
=> Old symlink
user.svg
=> New symlink
user-alt1.svg
```

If you do not like one alternate and want to try another, run like:

```bash
=> Old symlink
user-alt1.svg
=> New symlink
user-alt2.svg
```

### File manager icon

1. Go to the folder  `/usr/share/applications`, for example, if you want to change the default icon of Nautilus, your favourite file manager, find `nautilus.desktop` 
2. Run as `sudo` and change `Icon=...` to any of these:

 * `Icon=file-manager`
 * `Icon=caja`
 * `Icon=nautilus`
 * `Icon=nemo`
 * `Icon=sapcefm-find`
 * `Icon=thunar`


Remember that if you make an upgrade of your system, these desktop files will revert to the original icon name. Move them to `~./local/share/applications`. Note that after the upgrade of your system, it will add the desktop files in the `/usr/share/applications`, so you need to remove them. 

## Known bugs

### Snap-built apps

Unfortunately the snap-built apps are not supported almost by any icons themes, because the icons are hardcoded and the desktop files are not hosted in the folder `~/.local/share/applications` or `/usr/share/applications`.

To solve it, please follow the instructions:

1. Do:

```bash
# Copy all desktop files of all snap-built apps to "~/.local/share/applications"
sudo cp /var/lib/snapd/desktop/applications/*.desktop ~/.local/share/applications
# To de-sudo the files
sudo chmod -R 777 ~/.local/share/applications
# To remove the duplicates
sudo rm /var/lib/snapd/desktop/applications/*.desktop
```

2. Go to the directory  `~/.local/share/applications`;
3. Open each desktop file of snap app with your favourite text editor and modify the encoded path of `Icon` to the simple path with no extension. For example, if you use Insomnia:

```bash
Icon=snap/icons/icon.png
Icon=insomnia
```

4. Run `update-desktop-database` in the terminal.

### AppImage-built apps

With AppImageLauncher installed, you click an AppImage, it is automatically integrated to `~/Applications`, and desktop files are automatically created into `~/local/share/applications`. But if you modify one of the AppImage-built app desktop file to correct the icon path, AppImageLauncher reverts automatically the desktop file to the original and keeps again the icon path hardcoded. It also removes the option `StartupWMClass`. We recommend you to ban `AppImageLauncher`. 

1. Remove `appimagelauncher` via terminal;
2. Create `~/Applications/AppImages/`, move all AppImages to this folder. Make all AppImages executable and trusted:

```bash
chmod a+x *.AppImage
```

3. Reboot;
4. Create the desktop files manually in the directory `~/.local/share/applications`. Do not forget of adding the option `StartupWNClass` or the icon will be unrecognised or ugly. The desktop file, for example, `ColourPicker.desktop`, should be like:

```
[Desktop Entry]
Categories = Graphics;
Comment = A mininal but complete color picker
Comment[en_GB] = A mininal but complete colour picker
Exec = $HOME/Applications/AppImages/ColorPicker.AppImages
GenericName = Color Picker
GenericName[en_GB] = Colour Picker
Icon = colorpicker
Name = Color Picker
Name[en_GB] = Colour Picker
StartupNotify = true
StartupWMClass = ColorPicker
Terminal = false
Type = Application
Version = 1.0
```

And run `update-desktop-database`.

**Tips**

* To know which `StartupWNClass` name, it is the original same AppImage, for example, see in bold: <b><code>ColorPicker</b>.AppImage</code>. If it does not work, you need to extract the AppImage to figure the `bin` shell name. 
* If you are foreigner and want comment and name in your native language, you can add, for example, `Comment[en_GB]`, `GenericName[en_GB]` and `Name[en_GB]`. If to Spanish, it would  be`[es]`, and to Spanish from Mexico, `[es_MX]`. 
* The AppImage names should remain original, but if you want to rename, you are free, but for the `StartupWNClass` name, you need to put the original name of that AppImage.

### Hardcoded application icons with ugly name

We have already icons, but it is wrong or ugly name, or because the icon is hardcoded. For example, the application GitHub Desktop used `Icon=desktop.png` and other apps, like Insomnia, use `Icon=icon.png`, or worse, `Icon=stupid/path/icon.png`. 

To deal with hardcoded application icons we recommend to install [hardcode-fixer](https://github.com/Foggalong/hardcode-fixer). Suru++ supports most of the applications in the list. If [hardcode-fixer](https://github.com/Foggalong/hardcode-fixer) doesn't support your favourite app yet, please open an [issue here](https://github.com/Foggalong/hardcode-fixer/issues) or edit your .desktop file manually.

### Unattractive icons of Bluetooth Manager, Gigolo, Network Wifi, etc.

Because the desktop files use the 16px icons of `actions`, `mimetypes`, `panel` and `places` and not the icons of `apps` and `categories`. Therefore, you need to change manually the icon names in the desktop files to catch the icons of `apps`. You can pick of categoric and generic icons:

* `accessibility`
* `addressbook`
* `agenda`
* `application`
* `applications-engineering`
* `applications-interfacedesign`
* `archiver`
* `audio`
* `bluetooth`
* `book`
* `bookworm`
* `broom`
* `browser`
* `bug`
* `caffeine`
* `calculator`
* `calendar`
* `camera`
* `cdrom`
* `charmap`
* `chat`
* `chess`
* `cipher`
* `clipboard`
* `clock`
* `coin`
* `color-picker`
* `colour`
* `computer`
* `database`
* `debian`
* `desktop`
* `dictionary`
* `document`
* `download`
* `ebook`
* `effects`
* `emacs`
* `file-manager`
* `film`
* `flash`
* `font`
* `gameboy`
* `git`
* `hammer`
* `harddisk`
* `help`
* `icons`
* `image-viewer`
* `image`
* `java`
* `keyboard`
* `kronometer`
* `language`
* `leaf`
* `library`
* `login`
* `mail`
* `maps`
* `mate`
* `menu`
* `microphone`
* `monitor`
* `mouse`
* `music`
* `network`
* `night`
* `notepad`
* `notification`
* `package`
* `paint`
* `panel`
* `partitions`
* `password`
* `phone`
* `plasma`
* `plugin`
* `power`
* `ppa`
* `printer`
* `programming`
* `qt`
* `radio`
* `ruby`
* `scissors`
* `screenshot`
* `search`
* `settings`
* `share`
* `shield`
* `shop`
* `star`
* `steam`
* `sublime-text`
* `subtitleeditor`
* `tablet`
* `tag`
* `television`
* `terminal`
* `tool`
* `update`
* `upload`
* `usb`
* `user`
* `video-alt`
* `video-card`
* `voice`
* `wallpaper`
* `weather`
* `webcam`
* `wifi`
* `workspace`


### Hardcoded tray icons

To fix hardcoded tray icons, install and use [Hardcode-Tray script](https://github.com/bil-elmoussaoui/Hardcode-Tray). A list of supported applications is available here.

To get Suru++ to work right with [Hardcode-Tray script](https://github.com/bil-elmoussaoui/Hardcode-Tray), use the `hardcode-tray option --conversion-tool RSVGConvert`:

```bash
sudo -E hardcode-tray --conversion-tool RSVGConvert --size 22 --theme Suru++
```

### Unrecognised and ugly icons

#### Okular icon and other icons

Not just Suru++, it also affects Numix icons theme. It is a missed `StartupWMClass` option in the desktop files in KDE and an icon cache bug in GNOME and KDE. 

1. Install and use [StartupWMClassFixer](https://github.com/bilelmoussaoui/StartupWMClassFixer);
2. Install and use [Stacer](https://github.com/oguzhaninan/Stacer) to clean caches;
3. Log out and log in.

## Report

* Do you find the missed icons?
* Do you find the misused and ugly icons?
* Did you find the errors?

Report, but please provide well-detailed information. Or I will have difficulty to understand what you are saying or to know which app you are referring.

## Contribution

* Would you like to improve our repository?
* Do you want to add and request the icons? Make a pull request and we will analyse and approve or not.

## Contributors

The contributors is on the file [AUTHORS](AUTHORS).

## Changelog

The changelog is available on the release page in theme's repository.

## Credits and Licences

* CC BY-SA/GPL3 © 2018-2019 [Suru Icons](https://github.com/snwh/suru-icon-theme) by [Sam Hewitt](https://github.com/snwh).
* GPL3 © 2018-2019 [Suru++ Ubuntu](https://github.com/Bonandry/suru-plus) by [Andrea Bonanni](https://github.com/Bonandry) and Gustavo Costa.
* GPL3 © 2018-2019 Suru++ 25 by Gustavo Costa.
* GPL3 © [Papirus](https://github.com/PapirusDevelopmentTeam/) by [Alexey Varfolomeev](https://github.com/varlesh).
* GPL3 © [Numix](https://github.com/numixproject/numix-icon-theme) by Numix Team.
* GPL3/MIT © 2015-2019 [La Capitaine](https://github.com/keeferrourke/la-capitaine-icon-theme) by [Keefer Rourke](https://github.com/keeferrourke).
* MIT © Icons 8 by Gravit Designer<sup>1</sup>
* MIT © Twemoji by Twitter Team.

<hr>
<sup>1</sup> Gravit Designer has a special agreement with Icons 8 and allows the Pro user of Gravit Designer to use any icon without attribution and to sub-licence under an open source licence. See the <a href="https://discuss.gravit.io/t/licence-of-icons/2767">topic here</a>.