|
1 | | -<p align="center"> |
2 | | -<img src="images/logo-nuovo.svg" alt="Logotype"> |
3 | | -</p> |
4 | | - |
5 | | -<h3 align="center">A third-party Suru icons for Ubuntu</h3> |
6 | | -<h3 align="center">Optimized for Ubuntu 18.04, 18.10 and 19.04</h3> |
7 | | -<h3 align="center">An elegant, modern and sweet Suru icons based on <a href="https://snwh.org/suru">Suru Icons</a> by Sam Hewitt</h3> |
8 | | - |
9 | | - |
10 | | - |
11 | | -<h1>Index</h1> |
12 | | - |
13 | | -- [What is new in the version 17.1?](#what-is-new-in-the-version-171) |
14 | | -- [Installing with CLI](#installing-with-cli) |
15 | | - - [ROOT directory (recommended)](#root-directory-recommended) |
16 | | - - [HOME directory for GTK](#home-directory-for-gtk) |
17 | | - - [For Lubuntu users](#for-lubuntu-users) |
18 | | - - [For non-Ubuntu users](#for-non-ubuntu-users) |
19 | | - - [Uninstall](#uninstall) |
20 | | -- [Known bugs](#known-bugs) |
21 | | - - [Snap-built apps](#snap-built-apps) |
22 | | - - [AppImage-built apps](#appimage-built-apps) |
23 | | - - [Hardcoded application icons with ugly name](#hardcoded-application-icons-with-ugly-name) |
24 | | - - [Unattractive icons of Bluetooth Manager, Gigolo, Network Wifi, etc.](#unattractive-icons-of-bluetooth-manager-gigolo-network-wifi-etc) |
25 | | - - [Unrecognised and ugly icons](#unrecognised-and-ugly-icons) |
26 | | - - [Okular icon and other icons](#okular-icon-and-other-icons) |
27 | | - - [Do you support non-GNOME distros?](#do-you-support-non-gnome-distros) |
28 | | -- [Report](#report) |
29 | | -- [Contribution](#contribution) |
30 | | -- [Authors and Contributors](#authors-and-contributors) |
31 | | -- [Changelog](#changelog) |
32 | | -- [Credits and Licences](#credits-and-licences) |
33 | | - |
34 | | - |
35 | | -## What is new in the version 17.1? |
36 | | - |
37 | | -- Added three alternatives of Firefox that you can choose: |
38 | | - |
39 | | -| <img src="Suru++-Ubuntu/apps/scalable/firefox.svg" alt="Firefox Traditional" height="100px"> | <img src="Suru++-Ubuntu/apps/scalable/firefox-20.svg" alt="Firefox Suru++ 20" height="100px"> | <img src="Suru++-Ubuntu/apps/scalable/firefox-mozilla.svg" alt="Firefox Mozilla" height="100px"> | |
40 | | -| :----------------------------------------------------------------------------: | :-----------------------------------------------------------------------------: | :--------------------------------------------------------------------------------: | |
41 | | -| Traditional | Suru++ 25 | Mozilla Unofficial | |
42 | | -| `firefox.svg` | `firefox-20.svg` | `firefox-mozilla.svg` | |
43 | | - |
44 | | -**How to change the alternative of these?** |
45 | | - |
46 | | -1. Go to `/usr/share/applications/`; |
47 | | -2. Go to the desktop file `Firefox`; |
48 | | -3. Open the file with your favourite text editor; |
49 | | -4. Find `Icon=...` and modify it with one of three alternatives: `Icon=firefox` or `Icon=firefox-20` or `Icon=firefox-mozilla`. Save it. |
50 | | - |
51 | | -## Installing with CLI |
52 | | - |
53 | | -Use the scripts to install the latest version directly from this repository (independently of your distribution): |
54 | | - |
55 | | -**NOTE:** Use the same command to update the icon theme. |
56 | | - |
57 | | -#### ROOT directory (recommended) |
58 | | - |
59 | | -``` |
60 | | -wget -qO- https://raw.githubusercontent.com/Bonandry/suru-plus-ubuntu/master/install.sh | sh |
61 | | -``` |
62 | | - |
63 | | -#### HOME directory for GTK |
64 | | - |
65 | | -``` |
66 | | -wget -qO- https://raw.githubusercontent.com/Bonandry/suru-plus-ubuntu/master/install.sh | env DESTDIR="$HOME/.icons" sh |
67 | | -``` |
68 | | - |
69 | | -### For Lubuntu users |
70 | | - |
71 | | -As you want 24px and 26px icons to be colourful in the panel, and want the dark theme, please visit: |
72 | | - |
73 | | -* [Suru++ Lubuntu](https://github.com/gusbemacbe/suru-plus-lubuntu/) |
74 | | - |
75 | | -### For non-Ubuntu users |
76 | | - |
77 | | -This repository is designed only for Ubuntu, from 18.04 to 19.04. If you want the support for non-GNOME and non-Ubuntu, please visit [@gusbemacbe](https://github.com/gusbemacbe)’s [Suru++ 25](https://github.com/gusbemacbe/suru-plus). |
78 | | - |
79 | | -### Uninstall |
80 | | - |
81 | | -``` |
82 | | -wget -qO- https://raw.githubusercontent.com/gusbemacbe/suru-plus-ubuntu/master/install.sh | env uninstall=true sh |
83 | | -``` |
84 | | - |
85 | | -## Known bugs |
86 | | - |
87 | | -### Snap-built apps |
88 | | - |
89 | | -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`. |
90 | | - |
91 | | -To solve it, please follow the instructions: |
92 | | - |
93 | | -1. Do: |
94 | | - |
95 | | -```bash |
96 | | -# Copy all desktop files of all snap-built apps to "~/.local/share/applications" |
97 | | -sudo cp /var/lib/snapd/desktop/applications/*.desktop ~/.local/share/applications |
98 | | -# To de-sudo the files |
99 | | -sudo chmod -R 777 ~/.local/share/applications |
100 | | -# To remove the duplicates |
101 | | -sudo rm /var/lib/snapd/desktop/applications/*.desktop |
102 | | -``` |
103 | | - |
104 | | -2. Go to the directory `~/.local/share/applications`; |
105 | | -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: |
106 | | - |
107 | | -```bash |
108 | | -Icon=snap/icons/icon.png |
109 | | -Icon=insomnia |
110 | | -``` |
111 | | - |
112 | | -4. Run `update-desktop-database` in the terminal. |
113 | | - |
114 | | -### AppImage-built apps |
115 | | - |
116 | | -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`. |
117 | | - |
118 | | -1. Remove `appimagelauncher` via terminal; |
119 | | -2. Create `~/Applications/AppImages/`, move all AppImages to this folder. Make all AppImages executable and trusted: |
120 | | - |
121 | | -```bash |
122 | | -chmod a+x *.AppImage |
123 | | -``` |
124 | | - |
125 | | -3. Reboot; |
126 | | -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: |
127 | | - |
128 | | -``` |
129 | | -[Desktop Entry] |
130 | | -Categories = Graphics; |
131 | | -Comment = A mininal but complete color picker |
132 | | -Comment[en_GB] = A mininal but complete colour picker |
133 | | -Exec = $HOME/Applications/AppImages/ColorPicker.AppImages |
134 | | -GenericName = Color Picker |
135 | | -GenericName[en_GB] = Colour Picker |
136 | | -Icon = colorpicker |
137 | | -Name = Color Picker |
138 | | -Name[en_GB] = Colour Picker |
139 | | -StartupNotify = true |
140 | | -StartupWMClass = ColorPicker |
141 | | -Terminal = false |
142 | | -Type = Application |
143 | | -Version = 1.0 |
144 | | -``` |
145 | | - |
146 | | -And run `update-desktop-database`. |
147 | | - |
148 | | -**Tips** |
149 | | - |
150 | | -* 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. |
151 | | -* 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]`. |
152 | | -* 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. |
153 | | - |
154 | | -### Hardcoded application icons with ugly name |
155 | | - |
156 | | -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`. |
157 | | - |
158 | | -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. |
159 | | - |
160 | | -### Unattractive icons of Bluetooth Manager, Gigolo, Network Wifi, etc. |
161 | | - |
162 | | -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`. |
163 | | - |
164 | | -### Unrecognised and ugly icons |
165 | | - |
166 | | -#### Okular icon and other icons |
167 | | - |
168 | | -Not just Suru++ Ubuntu and Suru++ 25, it also affects Antü, Flat Remix, La Capitaine, Numix, Papirus, and Zafiro icons theme. It is a missed `StartupWMClass` option in the desktop files in KDE and an icon cache bug in GNOME and KDE. |
169 | | - |
170 | | -1. Install and use [StartupWMClassFixer](https://github.com/bilelmoussaoui/StartupWMClassFixer); |
171 | | -2. Install and use [Stacer](https://github.com/oguzhaninan/Stacer) to clean caches; |
172 | | -3. Log out and log in. |
173 | | - |
174 | | -### Do you support non-GNOME distros? |
175 | | - |
176 | | -No, I do not. If I will add somehting else to this icons theme, it will increase bugs, ugliness in KDE and archive size. I would not like to work with fixing the bugs and to have headache. You musy consider the alternative icons theme: [@gusbemacbe](https://github.com/gusbemacbe)'s [Suru++ 15](https://github.com/gusbemacbe/suru-plus). |
177 | | - |
178 | | -## Report |
179 | | - |
180 | | -* Do you find the missed icons? |
181 | | -* Do you find the misused icons? |
182 | | -* Did you find the errors? |
183 | | - |
184 | | -Report, but please provide well-detailed informations. |
185 | | - |
186 | | -## Contribution |
187 | | - |
188 | | -See the file [CONTRIBUTING.md](CONTRIBUTING.md) |
189 | | - |
190 | | -## Authors and Contributors |
191 | | - |
192 | | -The contributors is on the file [AUTHORS](Suru++-Ubuntu/AUTHORS). |
193 | | - |
194 | | -## Changelog |
195 | | - |
196 | | -Please visit the [CHANGELOG](CHANGELOG). |
197 | | - |
198 | | -## Credits and Licences |
199 | | - |
200 | | -* CC-BYSA/GPL3 © Suru Icons by Sam Hewitt. |
201 | | -* GPL3 © 2018 Suru++ Ubuntu by Andrea Bonanni and Gustavo Costa. |
| 1 | +<img src="images/Logo with Title.svg?sanitize=true" alt="Logotype"> |
| 2 | + |
| 3 | +<a href="README.en.md"><img src="images/flags/flag-uk.png" alt="English" align="top" height="20px"> English</a> – To view README. <br/> |
| 4 | +<a href="README.it-IT.md"><img src="images/flags/flag-it.png" alt="Italiano" align="top" height="20px"> Italiano</a> – Per visualizzare README. |
| 5 | + |
| 6 | +<img src="images/flags/flag-uk.png" alt="English" align="top" height="20px"> Or you can visit quick the [wiki](https://github.com/Bonandry/suru-plus-ubuntu/wiki). <br/> |
| 7 | +<img src="images/flags/flag-it.png" alt="Italiano" align="top" height="20px"> O puoi visitare rapidamente il [wiki](https://github.com/Bonandry/suru-plus-ubuntu/wiki). |
0 commit comments