README.md
1Lüv (icon theme) - Upstream repository
2==============
3
4## [Sponsor Lüv by clicking here!](https://nxos.org/#sponsor).
5## Your support is truly appreciated.
6
7
8
9
10Icons are licensed under the [Creative Commons Attribution-ShareAlike International 4.0 License](https://creativecommons.org/licenses/by-sa/4.0/)
11
12## Please be aware that this is not "complete" yet with thousands of icons inside. Icons are added gradually. Check the [FAQ](https://github.com/NitruxSA/luv-icon-theme/wiki/L%C3%BCv-FAQ) for questions.
13
14
15Download
16========
17
18Icons and wallpapers are available to download directly from this repository. Clone this repository using the following command:
19
20* In a Terminal execute the following command:
21 * `git clone https://github.com/Nitrux/luv-icon-theme.git`
22
23Install
24========
25
26### Icons
27
28* Move the folder(s) *Luv* `/usr/share/icons` for all environments or `~/.icons` for GTK based environments or `~/.local/share/icons` for Plasma 5.
29* And finally select the theme in the Settings.
30
31### Wallpapers
32
33* For Plasma 5:
34 * Move the folders inside *Wallpapers* to `/usr/share/wallpapers` or `~/.local/share/wallpapers/`, right-click on the desktop and select "Desktop Settings", finally select the background.
35* For GTK:
36 * Copy the images to your Pictures folder; rename them if necessary, right-click the image and select "Use as wallpaper".
37
38
39Reporting missing icons
40========
41
42When reporting missing icons make sure to follow these steps so we can resolve it faster:
43
44### For Linux:
45
461. Add **screenshots** of the missing icon and the instances where it's displayed like: menus, taskbars, panels, notifications, etc.
472. Use the following title prefix (without the quotes): "[Linux] App_name Desktop_environment" - that way we can tag them appropriately.
483. Add the relevant launcher information, software uses files with the extension *.desktop* as launchers for menus like Kickoff, Kicker, Mint menu, Gnome Shell overview, Unity dash, Whisker menu, etc. and these launchers are stored in `/usr/share/applications` (there might be a */kde* or */kde4* folder for KDE apps) for software installed through a package or the package manager. User-installed binaries and Google Chrome apps install their launchers here: `/home/$USER/.local/share/applications/`. Simply open these `.desktop` files with any text editor; copy and paste the line that says `Icon=` to your issue.
494. Add a description of the software, it's very important for us to know what the software does.
50
51Some software uses absolute paths in their launchers, as such even when we add the icon the system will not load it, you may use [Hardcoded Icon Fixer](https://github.com/Foggalong/hardcode-fixer) to resolve this problem.
52
